@Repository与@Mapper核心区别详解

以下是 @Repository 和 @Mapper 注解的核心区别及使用场景的总结，结合技术实现和实际开发需求整理：

---

📊 ​一、核心区别概览​

​特性​	​​@Repository​	​​@Mapper​
​来源​	Spring 框架	MyBatis 框架
​作用对象​	DAO 层接口或实现类	MyBatis 的 Mapper 接口
​主要功能​	标识 Spring Bean，封装数据访问异常	动态生成 MyBatis 代理类，执行 SQL 映射
​依赖配置​	需配合 @ComponentScan 或 @MapperScan	单独使用即可，无需额外配置
​异常处理​	自动转换异常为 Spring DataAccessException	无内置异常转换，依赖 MyBatis 原生异常
​IDE 兼容性​	无警告，Spring 可识别 Bean	单独使用时可能报“找不到 Bean”警告（不影响运行）

---

⚙️ ​二、注解详解与使用场景​

​1. @Repository（Spring 框架）​​

• ​作用​
  标识数据访问层（DAO）组件，将类注册为 Spring Bean，同时将底层异常（如 JDBC、JPA 异常）统一转换为 Spring 的 DataAccessException。
• ​使用场景​
  • 配合 Spring Data JPA、Hibernate 等 ORM 框架；
  • 需统一异常处理时；
  • 需显式声明 DAO 层为 Spring 组件（如结合 @ComponentScan 扫描）。
• ​配置要求​
  需在配置类或启动类添加组件扫描（如 @ComponentScan("com.dao")）或 MyBatis 专用扫描（@MapperScan）。

​2. @Mapper（MyBatis 框架）​​

• ​作用​
  标记 MyBatis 的 Mapper 接口，由 MyBatis 在运行时动态生成代理类，实现 SQL 映射（无需手动编写实现类）。
• ​使用场景​
  • 纯 MyBatis 项目，无需 Spring 整合；
  • 需精细控制 SQL（如动态 SQL、复杂查询）；
  • 避免 XML 配置文件，使用注解直接编写 SQL（如 @Select、@Update）。
• ​配置要求​
  单独使用即可，但推荐在启动类添加 @MapperScan("com.mapper") 批量扫描接口，避免每个接口单独标注 @Mapper。

---

🛠️ ​三、实际开发中的选择建议​

1. ​单一使用场景​

   • ​纯 MyBatis 项目​ → 优先用 @Mapper，无 Spring 依赖；
   • ​Spring + JPA 项目​ → 用 @Repository，利用 Spring 异常管理。

2. ​整合 MyBatis + Spring 项目​

   • ​推荐组合​：启动类添加 @MapperScan + Mapper 接口使用 @Repository（解决 IDE 警告问题）；
   • ​简化方案​：仅用 @MapperScan，省略接口注解（需接受 IDE 警告）。

3. ​常见问题解决​

   • ​**@Mapper 接口注入报红**​ → 同时添加 @Repository 或 @Component；
   • ​动态 SQL 需求​ → 使用 MyBatis 的 @SelectProvider 或 XML 映射（@Mapper 更灵活）。

---

💎 ​总结​

​场景​	​推荐注解​	​原因​
​Spring + MyBatis 整合​	@MapperScan + @Repository	避免 IDE 警告，统一 Spring Bean 管理
​无需 Spring 的 MyBatis 项目​	@Mapper	轻量，无额外依赖
​Spring Data JPA 项目​	@Repository	原生支持异常转换，与 JPA 无缝协作

若需深入配置动态 SQL 或异常处理机制，可参考 MyBatis 官方文档 或 Spring Data JPA 指南。