在 Spring Boot 中，MyBatis 的“自動(dòng)提交”行為并不是 MyBatis 自己實(shí)現(xiàn)的，而是 由 Spring 框架通過(guò)事務(wù)管理器（PlatformTransactionManager）統(tǒng)一控制的。MyBatis 原生默認(rèn)是 不自動(dòng)提交（autoCommit=false），但在 Spring Boot 集成環(huán)境下，是否提交由 Spring 的事務(wù)傳播機(jī)制決定：

一、核心結(jié)論

? 所以你看到的“自動(dòng)提交”，其實(shí)是 Spring 在方法無(wú)事務(wù)注解時(shí)，為每個(gè)數(shù)據(jù)庫(kù)操作開啟并立即提交一個(gè)獨(dú)立事務(wù)。

二、Spring Boot 如何集成 MyBatis？

Spring Boot 通過(guò) mybatis-spring-boot-starter 自動(dòng)配置：

• 創(chuàng)建 SqlSessionFactory
• 創(chuàng)建 SqlSessionTemplate（線程安全的 SqlSession 代理）
• 注冊(cè) Mapper 接口為 Spring Bean

關(guān)鍵點(diǎn)：不再直接使用原生 SqlSession，而是通過(guò) SqlSessionTemplate 代理調(diào)用。

三、源碼分析：為什么“自動(dòng)提交”？

1.SqlSessionTemplate的代理機(jī)制

SqlSessionTemplate 是 MyBatis-Spring 提供的線程安全 SqlSession 實(shí)現(xiàn)，它內(nèi)部持有一個(gè) SqlSessionInterceptor（動(dòng)態(tài)代理）。

當(dāng)調(diào)用 Mapper 方法（如 userMapper.insert(user)）時(shí)，實(shí)際執(zhí)行路徑：

Mapper Proxy → SqlSessionTemplate → SqlSessionInterceptor.invoke()

查看 SqlSessionInterceptor.invoke() 源碼（簡(jiǎn)化版）：

public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    // 1. 獲取當(dāng)前 Spring 管理的 SqlSession（可能已存在事務(wù)上下文）
    SqlSession sqlSession = getSqlSession(
        SqlSessionTemplate.this.sqlSessionFactory,
        SqlSessionTemplate.this.executorType,
        SqlSessionTemplate.this.exceptionTranslator
    );
    try {
        // 2. 執(zhí)行 SQL（如 insert/update/delete/select）
        Object result = method.invoke(sqlSession, args);
        // 3. 如果當(dāng)前沒(méi)有 Spring 事務(wù)，則立即 commit（僅對(duì)更新操作）
        if (!isSqlSessionTransactional(sqlSession, SqlSessionTemplate.this.sqlSessionFactory)) {
            sqlSession.commit(true); // true 表示強(qiáng)制提交
        }
        return result;
    } catch (Throwable t) {
        // 異常處理...
        throw t;
    } finally {
        // 4. 如果不是 Spring 事務(wù)管理的 SqlSession，則關(guān)閉它
        if (!isSqlSessionTransactional(sqlSession, SqlSessionTemplate.this.sqlSessionFactory)) {
            sqlSession.close();
        }
    }
}

?? 關(guān)鍵判斷：isSqlSessionTransactional(...)

• 如果當(dāng)前線程 已有 Spring 事務(wù)（即處于 @Transactional 方法中），則返回 true，不提交、不關(guān)閉，交由 Spring 統(tǒng)一管理。
• 如果 沒(méi)有 Spring 事務(wù)，則返回 false，立即提交并關(guān)閉 SqlSession。

這就解釋了“自動(dòng)提交”的來(lái)源！

2.isSqlSessionTransactional的實(shí)現(xiàn)邏輯

該方法檢查當(dāng)前 SqlSession 是否被 Spring 事務(wù)管理：

// 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 事務(wù)同步的核心機(jī)制。
• 只有在 @Transactional 方法中，Spring 才會(huì)提前將 SqlSession 綁定到 ThreadLocal。
• 否則，holder == null，返回 false → 觸發(fā)自動(dòng)提交。

3. Spring 事務(wù)如何接管 SqlSession？

當(dāng)方法標(biāo)注 @Transactional 時(shí)，Spring 會(huì)：

1. 在方法開始前，通過(guò) DataSourceTransactionManager 開啟 JDBC 事務(wù)（connection.setAutoCommit(false)）。
2. 調(diào)用 SqlSessionUtils.getSqlSession() 時(shí)，發(fā)現(xiàn)已有事務(wù)，復(fù)用同一個(gè) Connection，并將其包裝為 SqlSession 存入 ThreadLocal。
3. 方法結(jié)束時(shí)，根據(jù)是否拋異常，調(diào)用 commit() 或 rollback()。
4. 最終由 Spring 負(fù)責(zé) close()。

此時(shí)，SqlSessionTemplate 不會(huì)干預(yù)提交行為。

四、驗(yàn)證實(shí)驗(yàn)

場(chǎng)景 1：無(wú)@Transactional

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;
    public void saveUser(User user) {
        userMapper.insert(user); // 自動(dòng)提交！
    }
}

? 插入成功，即使后續(xù)代碼拋異常，數(shù)據(jù)也不會(huì)回滾。

場(chǎng)景 2：有@Transactional

@Transactional
public void saveUserWithTx(User user) {
    userMapper.insert(user);
    throw new RuntimeException("模擬異常"); // 數(shù)據(jù)會(huì)回滾！
}

? 插入被回滾，因?yàn)檎麄€(gè)方法是一個(gè)事務(wù)。

五、配置項(xiàng)說(shuō)明

雖然 MyBatis 有 autoCommit 配置，但在 Spring Boot 中 幾乎無(wú)效，因?yàn)椋?/p>

• Spring 通過(guò) DataSource 獲取 Connection，并由事務(wù)管理器控制 setAutoCommit()。
• MyBatis 的 autoCommit 參數(shù)在 SqlSessionFactoryBean 中會(huì)被忽略（或覆蓋）。

所以，不要依賴 MyBatis 的 autoCommit，而應(yīng)使用 Spring 的 @Transactional。

六、總結(jié)

?? 最佳實(shí)踐：

• 簡(jiǎn)單查詢/單條寫入：無(wú)需 @Transactional，享受自動(dòng)提交。
• 多操作一致性要求：必須加 @Transactional。
• 永遠(yuǎn)不要在 Service 層手動(dòng)調(diào)用 sqlSession.commit()！

通過(guò) Spring 的聲明式事務(wù)，開發(fā)者既能獲得“自動(dòng)提交”的便利，又能靈活控制復(fù)雜事務(wù)，這正是 Spring Boot + MyBatis 的強(qiáng)大之處。

到此這篇關(guān)于在Spring Boot中MyBatis 的自動(dòng)提交行為全解析(最新整理)的文章就介紹到這了,更多相關(guān)Spring Boot MyBatis 自動(dòng)提交內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論