Spring Boot 2.x整合Mybatis的方式有哪些

# Spring Boot 2.x整合Mybatis的方式有哪些 ## 前言 MyBatis作为一款优秀的持久层框架，在Spring Boot生态中有着广泛的应用。Spring Boot 2.x版本提供了多种与MyBatis整合的方式，开发者可以根据项目需求选择最适合的整合方案。本文将详细介绍三种主流整合方式及其实现细节。 ## 一、官方starter整合（推荐方式） ### 1. 引入依赖 ```xml <!-- Spring Boot MyBatis官方starter --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.2.0</version> </dependency> <!-- 数据库驱动（以MySQL为例） --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> 

2. 配置数据源

# application.yml spring: datasource: url: jdbc:mysql://localhost:3306/test_db username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml # XML映射文件位置 type-aliases-package: com.example.model # 实体类包路径 

3. 创建Mapper接口

@Mapper // 关键注解 public interface UserMapper { @Select("SELECT * FROM users WHERE id = #{id}") User findById(Long id); } 

4. 特点分析

• 自动配置：自动创建SqlSessionFactory和SqlSessionTemplate
• 简化开发：无需手动编写MyBatis配置
• 生产推荐：适合大多数标准项目场景

二、注解方式整合（无XML配置）

1. 核心注解说明

注解	作用
@Mapper	标识MyBatis接口
@Select	定义查询SQL
@Insert	定义插入SQL
@Update	定义更新SQL
@Delete	定义删除SQL
@Results	结果集映射
@Result	单字段映射

2. 完整示例

@Mapper public interface ProductMapper { @Insert("INSERT INTO products(name,price) VALUES(#{name},#{price})") @Options(useGeneratedKeys = true, keyProperty = "id") int insert(Product product); @Select("SELECT * FROM products WHERE id = #{id}") @Results({ @Result(property = "id", column = "id"), @Result(property = "name", column = "name"), @Result(property = "price", column = "price") }) Product selectById(Long id); } 

3. 适用场景

• 简单CRUD操作
• 不希望维护XML文件的场景
• 快速原型开发

三、XML配置方式整合

1. 项目结构

src/main/resources ├── application.yml └── mapper ├── UserMapper.xml └── ProductMapper.xml 

2. XML映射文件示例

<!-- UserMapper.xml --> <mapper namespace="com.example.mapper.UserMapper"> <resultMap id="BaseResultMap" type="User"> <id column="id" property="id" /> <result column="username" property="username" /> </resultMap> <select id="selectAll" resultMap="BaseResultMap"> SELECT * FROM users </select> </mapper> 

3. 接口与XML配合

public interface UserMapper { List<User> selectAll(); // 方法名与XML中的id对应 } 

4. 配置项说明

mybatis: config-location: classpath:mybatis-config.xml # 全局配置文件（可选） mapper-locations: classpath:mapper/**/*.xml # 支持通配符 

四、混合模式整合

1. 实现方式

@Mapper public interface OrderMapper { // 注解方式 @Select("SELECT * FROM orders WHERE id = #{id}") Order findSimpleOrder(Long id); // XML方式 Order findComplexOrderWithDetails(Long id); } 

<!-- OrderMapper.xml --> <select id="findComplexOrderWithDetails" resultMap="OrderDetailResult"> <!-- 复杂关联查询 --> </select> 

2. 最佳实践建议

• 简单查询使用注解
• 复杂查询（动态SQL、关联查询）使用XML
• 保持风格一致性

五、高级整合技巧

1. 分页插件整合

<dependency> <groupId>com.github.pagehelper</groupId> <artifactId>pagehelper-spring-boot-starter</artifactId> <version>1.4.1</version> </dependency> 

2. 多数据源配置

@Configuration @MapperScan(basePackages = "com.example.db1", sqlSessionTemplateRef = "db1SqlSessionTemplate") public class Db1Config { // 配置第一个数据源... } @Configuration @MapperScan(basePackages = "com.example.db2", sqlSessionTemplateRef = "db2SqlSessionTemplate") public class Db2Config { // 配置第二个数据源... } 

六、总结对比

整合方式	优点	缺点	适用场景
官方starter	开箱即用，配置简单	定制化能力较弱	标准项目快速开发
纯注解方式	无XML，代码直观	复杂SQL可读性差	简单CRUD操作
XML配置方式	复杂SQL易维护，支持动态SQL	需要维护额外文件	复杂查询场景
混合模式	灵活平衡开发效率与维护性	风格需要统一	中大型项目

最终建议：对于新项目推荐使用官方starter+注解为主、XML为辅的混合模式，既能保证开发效率，又能应对复杂查询需求。 “`

注：本文示例代码基于Spring Boot 2.5.x + MyBatis 3.5.x版本，实际使用时请根据具体版本调整依赖和配置。