Spring JdbcTemplate 事務管理深度實踐：從手動控制到聲明式事務的避坑指南

Spring JdbcTemplate 事務管理深度實踐：從手動控制到聲明式事務的避坑指南

在純 Spring + JdbcTemplate 架構下實現事務一致性，看似簡單實則暗藏玄機。本文記錄一次真實的「先刪後增」業務場景中，從自動提交、手動控制到聲明式事務的完整踩坑歷程，揭示連接池、資料庫引擎、Spring 事務管理器的深層交互機制。

業務場景與初始驗證

需求：為應用分配領域時，先刪除原有關聯，再插入新關聯。簡化為 Person 實體：同名先刪後增。

首先驗證 JdbcTemplate 預設行為：在 update 後拋出異常，發現數據已寫入，確認預設為自動提交模式。

手動事務控制的兩次失敗

嘗試 1：分別獲取連接設定自動提交

jdbcTemplate.getDataSource().getConnection().setAutoCommit(false);
jdbcTemplate.update(DELETE_SQL);  // 使用連接 A
jdbcTemplate.update(INSERT_SQL);  // 使用連接 B
jdbcTemplate.getDataSource().getConnection().commit();  // 提交連接 C

失敗原因：每次 getConnection() 都從連接池獲取不同的物理連接，三條語句分別在三個連接上執行，根本無法構成同一事務。

嘗試 2：原生 JDBC 統一連接

Connection conn = dataSource.getConnection();
conn.setAutoCommit(false);
PreparedStatement pstmt = conn.prepareStatement(DELETE_SQL);
pstmt.executeUpdate();
pstmt = conn.prepareStatement(INSERT_SQL);
pstmt.executeUpdate();
conn.commit();

依然失敗：數據庫引擎為 MyISAM，不支援事務！所有手動控制在引擎層面均無效。

關鍵發現：資料庫引擎決定論

將表引擎修改為 InnoDB 後，嘗試 2 成功實現事務一致性。但嘗試 1 依然失敗，根本原因在於連接身份不一致。

Spring 聲明式事務：正確的解決之道

配置事務管理器

<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource" />
</bean>
<tx:annotation-driven transaction-manager="transactionManager" />

業務代碼極致簡潔

@Transactional
public int insertOnePerson(String name, int age) {
    jdbcTemplate.update(DELETE_SQL, name);
    return jdbcTemplate.update(INSERT_SQL, name, age);
}

核心原理揭秘：Spring 如何統一連接？

Spring 透過 DataSourceTransactionManager 配合 ThreadLocal（DataSourceUtils），在事務開始時從連接池獲取一個連接並綁定到當前執行緒。後續同執行緒內的所有 JdbcTemplate 操作透過 DataSourceUtils.getConnection() 獲取到的正是同一個連接，從而保證事務邊界內操作的原子性。

避坑總結與最佳實務

專案依賴提示

• Lombok 需 IDE 安裝插件支援編譯
• Druid + MySQL 驅動版本需相容性測試

這次實踐深刻說明：事務管理的本質是連接的唯一性與引擎的支援性。Spring 的聲明式事務將這兩個條件完美封裝，是企業級開發的標準選擇。