在 Spring 和 MyBatis 集成開發中，@ComponentScan 和 @MapperScan 是兩個核心注解，但它們的用途和工作機制截然不同。本文將通過通俗的語言和示例代碼，帶您輕松掌握它們的區別和使用方法。

1. @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 接口）

1. @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）！