mapper的包扫描和@mapper的区别

### MyBatis中Mapper包扫描与@Mapper注解的区别及使用场景 #### 一、@Mapper 注解的作用 `@Mapper` 是 MyBatis 提供的一个注解，用于标记单个 Mapper 接口。当在一个接口上添加 `@Mapper` 注解时，MyBatis 会在运行时为该接口动态生成其实现类并将其注册到 Spring 容器中[^3]。 - **特点**： - 需要在每一个 Mapper 接口中单独添加此注解。 - 如果项目中有大量的 Mapper 接口，则逐一手动标注可能会显得繁琐。 - **适用场景**： - 当项目的 Mapper 接口较少时，适合直接使用 `@Mapper` 注解逐一标记。 - 对于小型项目或模块化设计良好的项目，这种方式简单直观。 ```java @Mapper public interface UserMapper { @Select("SELECT * FROM users WHERE id = #{id}") User findById(int id); } ``` --- #### 二、Mapper 包扫描（通过 @MapperScan 实现） `@MapperScan` 是一种更高效的批量处理方式，通常应用于 Spring Boot 或其他基于 Spring 的框架中。它允许开发者一次性指定一个或多个包路径，自动扫描这些包下的所有 Mapper 接口并将它们注册到 Spring 容器中[^4]。 - **特点**： - 只需在配置类或启动类中标记一次即可完成整个包下所有 Mapper 接口的注册。 - 减少了手动操作的工作量，尤其适用于大型项目。 - **适用场景**： - 大型项目中存在大量 Mapper 接口时，推荐使用 `@MapperScan` 进行统一管理。 - 方便维护和扩展，只需调整包名而无需修改具体接口代码。 ```java @SpringBootApplication @MapperScan("com.example.mapper") public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` --- #### 三、两者的对比分析 | 特性 | @Mapper | @MapperScan | |---------------------|-------------------------------------------|--------------------------------------------| | 使用范围 | 单个 Mapper 接口 | 整个包及其子包 | | 手动工作量 | 较高（每个接口都需要加注解） | 较低（仅需设置包路径） | | 易用性和可读性 | 更清晰地表明某个接口属于 Mapper | 统一集中管理，减少重复劳动 | | 性能影响 | 基本无差异 | 同样基本无差异 | --- #### 四、注意事项 1. 若同时使用了 `@Mapper` 和 `@MapperScan`，则两者不会冲突。但如果某些特殊情况下需要排除特定的 Mapper 接口，可以通过 `excludeFilters` 参数进一步控制[^4]。 2. 在实际开发过程中，建议优先考虑使用 `@MapperScan` 来简化配置流程，除非有特别需求才单独使用 `@Mapper`。 ---