Spring 与 MyBatis 整合时的事务管理细节
在 Spring 与 MyBatis 整合时，事务管理是确保数据一致性、隔离性和可靠性的核心环节。MyBatis 本身是一个轻量级的 ORM 框架，不直接管理事务，而是通过与 Spring 的集成，将事务的控制权交给 Spring，实现统一的事务管理机制。
🧠 一、Spring 与 MyBatis 整合事务管理的核心机制
1. 事务管理器的选择
在 Spring 中，事务的控制依赖于 PlatformTransactionManager 接口。对于 MyBatis，最常用的实现是：
org.springframework.jdbc.datasource.DataSourceTransactionManager
它负责管理基于单数据源的事务，确保事务的开启、提交和回滚。
注意：如果你使用的是多数据源或分布式事务，可以考虑
JtaTransactionManager。
2. MyBatis 的 SqlSession 与 Spring 事务的绑定
MyBatis 的 SqlSession 是执行数据库操作的核心接口。在 Spring 中，为了支持事务管理，SqlSession 必须与 Spring 的事务上下文绑定，确保在同一个事务中使用相同的数据库连接。
Spring 提供了 SqlSessionTemplate 和 SqlSessionInterceptor 来实现这一点：
- SqlSessionTemplate：线程安全的
SqlSession实现，内部使用ThreadLocal管理数据库连接。 - SqlSessionInterceptor：拦截
SqlSession的创建，确保其使用 Spring 管理的事务连接。
3. 事务的开启与提交
当使用 @Transactional 注解时，Spring 会：
- 调用
DataSourceTransactionManager.getTransaction()开启事务； - 在事务范围内，MyBatis 的
SqlSession会复用同一个数据库连接； - 方法正常结束时调用
commit()提交事务； - 方法抛出异常时调用
rollback()回滚事务。
📦 二、整合事务管理的关键配置
1. 配置数据源（DataSource）
@Bean
public DataSource dataSource() {return DataSourceBuilder.create().url("jdbc:mysql://localhost:3306/mydb").username("root").password("123456").build();
}
2. 配置事务管理器
@Bean
public PlatformTransactionManager transactionManager(DataSource dataSource) {return new DataSourceTransactionManager(dataSource);
}
3. 配置 SqlSessionFactory
@Bean
public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();factoryBean.setDataSource(dataSource);factoryBean.setMapperLocations(new PathMatchingResourcePatternResolver().getResources("classpath:mapper/*.xml"));return factoryBean.getObject();
}
4. 配置 SqlSessionTemplate
@Bean
public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {return new SqlSessionTemplate(sqlSessionFactory);
}
5. 启用事务管理
@Configuration
@EnableTransactionManagement
public class TransactionConfig {
}
🔄 三、事务管理的执行流程（简化版）
@Transactional
public void someServiceMethod() {sqlSession.insert("insertUser", user);sqlSession.update("updateUser", user);
}
- Spring AOP 拦截方法：
@Transactional注解方法被TransactionInterceptor拦截； - 开启事务：调用
DataSourceTransactionManager.getTransaction()； - 获取数据库连接：Spring 从数据源中获取连接，并绑定到当前线程（
ThreadLocal）； - 执行 MyBatis 操作：
SqlSessionTemplate获取SqlSession，内部使用 Spring 管理的连接； - 提交事务：方法正常结束，调用
commit()； - 回滚事务：方法抛出异常，调用
rollback()。
⚙️ 四、关键类与作用
| 类名 | 作用 |
|---|---|
DataSourceTransactionManager | Spring 提供的事务管理器，用于单数据源事务管理 |
SqlSessionTemplate | MyBatis 与 Spring 集成的核心类，线程安全，支持事务 |
SqlSessionInterceptor | 拦截 SqlSession 的创建，确保使用 Spring 管理的连接 |
SqlSessionFactoryBean | 用于创建 SqlSessionFactory，集成 Spring 管理的数据源 |
@EnableTransactionManagement | 启用 Spring 的事务管理功能 |
❗ 五、常见问题与解决方案
1. 事务失效：方法非 public
- 原因：Spring AOP 默认只拦截 public 方法。
- 解决：将事务方法设为 public，或使用 AspectJ 代理。
2. 事务失效：内部调用（self-invocation）
- 原因：同一类中调用
@Transactional方法，代理失效。 - 解决：通过注入自身 Bean 调用：
@Autowired
private MyService self;public void outerMethod() {self.innerMethod(); // 事务生效
}
3. 事务未正确提交或回滚
- 原因：未正确配置事务管理器或未启用事务。
- 解决：确认已注册
DataSourceTransactionManager并启用@EnableTransactionManagement。
4. MyBatis 操作未参与事务
- 原因：
SqlSession未使用 Spring 管理的连接。 - 解决：确保使用
SqlSessionTemplate或注入 Mapper 接口（推荐方式）。
✅ 六、最佳实践建议
| 建议 | 说明 |
|---|---|
使用 @Transactional 注解 | 推荐使用声明式事务，简洁易维护 |
使用 SqlSessionTemplate | 保证线程安全和事务一致性 |
| 使用 Mapper 接口注入 | 推荐使用 @MapperScan 自动扫描 Mapper 接口 |
| 避免手动管理事务 | 尽量避免使用编程式事务，除非有特殊需求 |
| 配置事务传播行为 | 明确事务传播行为（如 REQUIRED, REQUIRES_NEW） |
| 异常处理 | 明确事务回滚的异常类型（如 rollbackFor = Exception.class） |
🧩 七、Spring Boot 中的自动配置
在 Spring Boot 中，事务管理器和 MyBatis 的整合可以通过自动配置简化：
- 自动配置事务管理器：Spring Boot 会根据数据源自动配置
DataSourceTransactionManager。 - 自动配置 MyBatis：使用
mybatis-spring-boot-starter，自动配置SqlSessionFactory和SqlSessionTemplate。 - 自动扫描 Mapper 接口：使用
@MapperScan注解或mybatis.mapper-locations配置。
✅ 八、总结
| 特性 | Spring 与 MyBatis 整合事务管理 |
|---|---|
| 事务管理器 | DataSourceTransactionManager |
| 事务控制 | 基于 AOP 的声明式事务 |
| SqlSession 管理 | 使用 SqlSessionTemplate 或注入 Mapper 接口 |
| 事务绑定 | 使用 ThreadLocal 管理数据库连接 |
| 自动配置 | Spring Boot 可自动完成大部分配置 |
| 失效场景 | 方法非 public、内部调用、未正确配置事务管理器 |