在 Spring 和 MyBatis 集成开发中，@ComponentScan 和 @MapperScan 是两个核心注解，但它们的用途和工作机制截然不同。本文将通过通俗的语言和示例代码，带您轻松掌握它们的区别和使用方法。
一、基础概念
- @ComponentScan：Spring 的“通用扫描仪”
作用：扫描并注册 Spring 容器中的组件（如 @Service、@Repository、@Controller 等注解标注的类）。
特点：
默认扫描主类所在包及其子包。
无需额外配置即可自动装配通用组件。
无法直接处理 MyBatis 的 Mapper 接口（需要配合 @MapperScan）。
2. @MapperScan：MyBatis 的“专用扫描仪”
作用：扫描并注册 MyBatis 的 Mapper 接口（即数据库操作接口），将其转换为 Spring Bean。
特点：
需要显式配置扫描路径。
通过动态代理生成 Mapper 接口的实现类。
与 @Mapper 注解配合使用（可选）。
二、核心区别对比
|
特性
|
@ComponentScan
|
@MapperScan
|
|
扫描目标
|
扫描 Spring 组件（@Service、@Repository 等）
|
扫描 MyBatis 的 Mapper 接口（@Mapper 注解）
|
|
生成 Bean 的方式
|
直接注册标注类为 Bean
|
生成 Mapper 接口的动态代理类
|
|
是否默认启用
|
是（@SpringBootApplication 包含）
|
否（需显式配置）
|
|
典型使用场景
|
业务逻辑、控制层、通用组件
|
数据访问层（MyBatis 的 Mapper 接口）
|
三、使用方法详解
- @ComponentScan 的使用
场景：管理通用 Spring 组件（如 Service、Repository）
示例代码：
// 主类（默认扫描当前包及子包）
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
// Service 层
@Service
public class UserService {
public String getUser() {
return "User from Service";
}
}
// Repository 层
@Repository
public class UserRepository {
public String getUser() {
return "User from Repository";
}
}自定义扫描路径：
@SpringBootApplication
@ComponentScan(basePackages = {"com.example.service", "com.example.repository"})
public class Application {
// ...
}
2. @MapperScan 的使用
场景：管理 MyBatis 的 Mapper 接口
示例代码：
// 主类配置
@SpringBootApplication
@MapperScan("com.example.mapper") // 指定 Mapper 接口扫描路径
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
// Mapper 接口
@Mapper // 可选，如果 @MapperScan 已指定路径，则无需在此添加
public interface UserMapper {
@Select("SELECT * FROM users")
List<User> findAll();
}
替代方案：在配置类中使用：
@Configuration
@MapperScan("com.example.mapper") // 配置类中同样有效
public class MyBatisConfig {
// 可配置 MyBatis 相关 Bean（如拦截器）
}四、常见问题与误区
1.为什么不能仅用 @ComponentScan 加载 Mapper 接口？
原因：@ComponentScan 只负责注册 Bean，但 MyBatis 的 Mapper 接口需要动态代理生成实现类。如果仅依赖 @ComponentScan，调用时会抛出异常。
解决方法：必须使用 @MapperScan 或在每个 Mapper 接口上添加 @Mapper 注解。
2. @MapperScan 和 @ComponentScan 能同时使用吗？
答案：可以，但需注意扫描路径冲突
五、最佳实践
1.推荐用法
Mapper 接口：始终使用 @MapperScan 配置扫描路径，避免在每个接口上添加 @Mapper。
通用组件：依赖 @SpringBootApplication 内置的 @ComponentScan，或显式扩展扫描路径。
2. 错误示例与修正
错误示例：
// 仅使用 @ComponentScan 扫描 Mapper 接口（不可行）
@SpringBootApplication
@ComponentScan("com.example.mapper")
public class Application {
// ...
}
修正方法：
// 正确方式：使用 @MapperScan
@SpringBootApplication
@MapperScan("com.example.mapper")
public class Application {
// ...
}六、总结
1、@ComponentScan关键点：管理通用 Spring 组件（Service、Repository 等） 默认启用，无需额外配置
2、@MapperScan关键点：管理 MyBatis 的 Mapper 接口 必须显式配置扫描路径，支持动态代理生成
通过合理使用 @ComponentScan 和 @MapperScan，您可以高效管理 Spring 和 MyBatis 的组件，简化代码结构并提高开发效率。记住：Mapper 接口需要专用扫描仪（@MapperScan），而通用组件交给通用扫描仪（@ComponentScan）！