1. Spring Boot与MyBatis整合全景解析

在企业级Java应用开发中，数据持久层框架的选择直接影响着系统的性能和开发效率。MyBatis作为半自动化的ORM框架，通过XML或注解配置SQL语句，既保留了SQL的灵活性，又减少了JDBC的样板代码。而Spring Boot的自动配置特性，让这两个框架的整合变得异常简单。

我经历过从传统SSM架构到Spring Boot + MyBatis的技术转型，实测这套组合能减少约70%的配置工作量。特别是在快速迭代的业务场景中，这种组合能让开发者更专注于业务SQL的优化，而不是框架的整合。

2. 环境准备与项目初始化

2.1 创建Spring Boot项目

推荐使用Spring Initializr（start.spring.io）生成项目骨架，勾选以下依赖：

• Spring Web（用于构建Web层）
• MyBatis Framework（核心整合依赖）
• MySQL Driver（或其他数据库驱动）

对于Maven项目，pom.xml关键依赖如下：

<dependencies> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency> </dependencies>

2.2 数据库配置

application.yml典型配置示例：

spring: datasource: url: jdbc:mysql://localhost:3306/demo?useSSL=false&serverTimezone=UTC username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.demo.entity

注意：生产环境务必使用加密方式存储密码，推荐使用Jasypt等工具进行配置加密

3. MyBatis核心组件集成

3.1 实体类与Mapper接口

实体类示例（User.java）：

@Data // Lombok注解 public class User { private Long id; private String username; private String email; private LocalDateTime createTime; }

Mapper接口定义（UserMapper.java）：

@Mapper // 关键注解 public interface UserMapper { @Select("SELECT * FROM user WHERE id = #{id}") User selectById(Long id); @Insert("INSERT INTO user(username,email) VALUES(#{username},#{email})") @Options(useGeneratedKeys = true, keyProperty = "id") int insert(User user); }

3.2 XML映射文件配置

resources/mapper/UserMapper.xml示例：

<mapper namespace="com.example.demo.mapper.UserMapper"> <resultMap id="BaseResultMap" type="User"> <id column="id" property="id"/> <result column="username" property="username"/> <result column="email" property="email"/> <result column="create_time" property="createTime"/> </resultMap> <select id="selectByEmail" resultMap="BaseResultMap"> SELECT * FROM user WHERE email = #{email} </select> </mapper>

4. 高级特性实战

4.1 动态SQL应用

MyBatis强大的动态SQL能力：

<select id="selectUsers" resultMap="BaseResultMap"> SELECT * FROM user <where> <if test="username != null"> AND username LIKE CONCAT('%',#{username},'%') </if> <if test="email != null"> AND email = #{email} </if> </where> ORDER BY create_time DESC </select>

4.2 事务管理配置

在Service层添加事务控制：

@Service @Transactional // 类级别注解 public class UserService { @Autowired private UserMapper userMapper; public void createUser(User user) { userMapper.insert(user); // 其他数据库操作... } }

重要：默认只对RuntimeException回滚，检查异常需通过@Transactional(rollbackFor=Exception.class)指定

5. 性能优化技巧

5.1 二级缓存配置

在application.yml中启用缓存：

mybatis: configuration: cache-enabled: true

Mapper接口缓存注解：

@CacheNamespace // 开启二级缓存 public interface UserMapper { //... }

5.2 批量操作优化

使用BatchExecutor提升批量插入性能：

@Autowired private SqlSessionFactory sqlSessionFactory; public void batchInsert(List<User> users) { try(SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH)) { UserMapper mapper = session.getMapper(UserMapper.class); users.forEach(mapper::insert); session.commit(); } }

6. 常见问题排查

6.1 映射文件找不到问题

症状：Invalid bound statement (not found)错误

解决方案：

1. 检查mapper-locations路径是否正确
2. 确保XML文件在target/classes对应目录下
3. 检查namespace是否与Mapper接口全限定名一致

6.2 事务不生效场景

可能原因：

1. 方法非public修饰
2. 自调用问题（同类中方法互相调用）
3. 异常被catch未抛出
4. 数据库引擎不支持事务（如MyISAM）

7. 生产环境建议

1. 连接池配置优化（推荐HikariCP）：

spring: datasource: hikari: maximum-pool-size: 20 connection-timeout: 30000 idle-timeout: 600000

2. SQL监控配置：

• 集成Druid监控
• 使用P6Spy打印真实SQL

3. MyBatis日志输出配置：

logging: level: org.mybatis: DEBUG

8. 扩展集成方案

8.1 MyBatis-Plus整合

对于需要更强大CRUD功能的场景：

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> </dependency>

8.2 多数据源配置

使用AbstractRoutingDataSource实现：

@Configuration public class DataSourceConfig { @Bean @Primary public DataSource dynamicDataSource() { // 实现动态数据源切换逻辑 } }

在实际项目开发中，我发现合理使用MyBatis的拦截器（Interceptor）可以优雅地实现通用字段（如create_time, update_time）的自动填充。通过实现org.apache.ibatis.plugin.Interceptor接口，配合@Intercepts注解，可以统一处理这些重复性操作。