在 Spring Boot 中,MyBatis 的“自动提交”行为解析

在 Spring Boot 中,MyBatis 的"自动提交"行为并不是 MyBatis 自己实现的,而是 由 Spring 框架通过事务管理器(PlatformTransactionManager)统一控制 的。MyBatis 原生默认是 不自动提交autoCommit=false),但在 Spring Boot 集成环境下,是否提交由 Spring 的事务传播机制决定


一、核心结论

场景 是否自动提交? 控制者
原生 MyBatis(无 Spring) ❌ 默认不提交,需手动 sqlSession.commit() MyBatis 自身
Spring Boot + MyBatis(无 @Transactional 自动提交(每条 SQL 独立事务) Spring 的 DataSourceTransactionManager
Spring Boot + MyBatis(有 @Transactional ❌ 方法结束前不提交,成功则提交,异常则回滚 Spring 事务管理

✅ 所以你看到的"自动提交",其实是 Spring 在方法无事务注解时,为每个数据库操作开启并立即提交一个独立事务


二、Spring Boot 如何集成 MyBatis?

Spring Boot 通过 mybatis-spring-boot-starter 自动配置:

  • 创建 SqlSessionFactory
  • 创建 SqlSessionTemplate(线程安全的 SqlSession 代理)
  • 注册 Mapper 接口为 Spring Bean

关键点:不再直接使用原生 SqlSession,而是通过 SqlSessionTemplate 代理调用


三、源码分析:为什么"自动提交"?

1. SqlSessionTemplate 的代理机制

SqlSessionTemplate 是 MyBatis-Spring 提供的线程安全 SqlSession 实现,它内部持有一个 SqlSessionInterceptor(动态代理)。

当调用 Mapper 方法(如 userMapper.insert(user))时,实际执行路径:

复制代码
Mapper Proxy → SqlSessionTemplate → SqlSessionInterceptor.invoke()

查看 SqlSessionInterceptor.invoke() 源码(简化版):

复制代码
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    // 1. 获取当前 Spring 管理的 SqlSession(可能已存在事务上下文)
    SqlSession sqlSession = getSqlSession(
        SqlSessionTemplate.this.sqlSessionFactory,
        SqlSessionTemplate.this.executorType,
        SqlSessionTemplate.this.exceptionTranslator
    );

    try {
        // 2. 执行 SQL(如 insert/update/delete/select)
        Object result = method.invoke(sqlSession, args);
        
        // 3. 如果当前没有 Spring 事务,则立即 commit(仅对更新操作)
        if (!isSqlSessionTransactional(sqlSession, SqlSessionTemplate.this.sqlSessionFactory)) {
            sqlSession.commit(true); // true 表示强制提交
        }
        return result;
    } catch (Throwable t) {
        // 异常处理...
        throw t;
    } finally {
        // 4. 如果不是 Spring 事务管理的 SqlSession,则关闭它
        if (!isSqlSessionTransactional(sqlSession, SqlSessionTemplate.this.sqlSessionFactory)) {
            sqlSession.close();
        }
    }
}

🔍 关键判断:isSqlSessionTransactional(...)

  • 如果当前线程 已有 Spring 事务 (即处于 @Transactional 方法中),则返回 true不提交、不关闭,交由 Spring 统一管理。
  • 如果 没有 Spring 事务 ,则返回 false立即提交并关闭 SqlSession

这就解释了"自动提交"的来源!


2. isSqlSessionTransactional 的实现逻辑

该方法检查当前 SqlSession 是否被 Spring 事务管理:

复制代码
// org.mybatis.spring.SqlSessionUtils
public static boolean isSqlSessionTransactional(SqlSession session, SqlSessionFactory sessionFactory) {
    // 从 ThreadLocal 中获取 Spring 管理的 SqlSession
    SqlSessionHolder holder = (SqlSessionHolder) TransactionSynchronizationManager
        .getResource(sessionFactory);
    
    return (holder != null) && (holder.getSqlSession() == session);
}
  • TransactionSynchronizationManager.getResource() 是 Spring 事务同步的核心机制。
  • 只有在 @Transactional 方法中,Spring 才会提前将 SqlSession 绑定到 ThreadLocal
  • 否则,holder == null,返回 false → 触发自动提交。

3. Spring 事务如何接管 SqlSession?

当方法标注 @Transactional 时,Spring 会:

  1. 在方法开始前,通过 DataSourceTransactionManager 开启 JDBC 事务(connection.setAutoCommit(false))。
  2. 调用 SqlSessionUtils.getSqlSession() 时,发现已有事务,复用同一个 Connection ,并将其包装为 SqlSession 存入 ThreadLocal
  3. 方法结束时,根据是否抛异常,调用 commit()rollback()
  4. 最终由 Spring 负责 close()

此时,SqlSessionTemplate 不会干预提交行为。


四、验证实验

场景 1:无 @Transactional

复制代码
@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

    public void saveUser(User user) {
        userMapper.insert(user); // 自动提交!
    }
}

✅ 插入成功,即使后续代码抛异常,数据也不会回滚。

场景 2:有 @Transactional

复制代码
@Transactional
public void saveUserWithTx(User user) {
    userMapper.insert(user);
    throw new RuntimeException("模拟异常"); // 数据会回滚!
}

❌ 插入被回滚,因为整个方法是一个事务。


五、配置项说明

虽然 MyBatis 有 autoCommit 配置,但在 Spring Boot 中 几乎无效,因为:

  • Spring 通过 DataSource 获取 Connection,并由事务管理器控制 setAutoCommit()
  • MyBatis 的 autoCommit 参数在 SqlSessionFactoryBean 中会被忽略(或覆盖)。

所以,不要依赖 MyBatis 的 autoCommit,而应使用 Spring 的 @Transactional


六、总结

问题 答案
Spring Boot 中 MyBatis 为何"自动提交"? 因为 Spring 在无事务方法中,为每次 Mapper 调用创建独立事务并立即提交。
源码关键类 SqlSessionTemplate.SqlSessionInterceptor + SqlSessionUtils
控制提交行为的方式 使用 @Transactional 注解,而非 MyBatis 配置
是否应关闭"自动提交"? 不需要关闭,这是 Spring 的合理默认行为;需事务时加 @Transactional 即可

💡 最佳实践

  • 简单查询/单条写入:无需 @Transactional,享受自动提交。
  • 多操作一致性要求:必须加 @Transactional
  • 永远不要在 Service 层手动调用 sqlSession.commit()

通过 Spring 的声明式事务,开发者既能获得"自动提交"的便利,又能灵活控制复杂事务,这正是 Spring Boot + MyBatis 的强大之处。

相关推荐
徐子童1 小时前
数据结构----排序算法
java·数据结构·算法·排序算法·面试题
wind_one11 小时前
13.基础--SQL--DQL-聚合函数
数据库·sql
xiaohua10092 小时前
ZGC实践
java·jvm
猿小喵2 小时前
浅谈MySQL的redo日志
数据库·mysql
蒂法就是我2 小时前
策略模式在spring哪里用到了?
java·spring·策略模式
青衫码上行2 小时前
【Java Web学习 | 第14篇】JavaScript(8) -正则表达式
java·前端·javascript·学习·正则表达式
陳陈陳2 小时前
AIGC 时代,用自然语言操作数据库:SQLite + LLM 的轻量级实践
前端·数据库·python
拽着尾巴的鱼儿2 小时前
工具篇:Window10 增加虚拟内存&Idea项目启动内存配置
java·ide·intellij-idea
q***13613 小时前
SpringSecurity相关jar包的介绍
java·jar