Spring Boot NESTED 報 TransactionSystemException

NESTED 傳播行為的部分回滾依賴底層數據庫保存點（Savepoint）能力。在 Spring 中，基於 JDBC 的 DataSourceTransactionManager 原生支持保存點，但 JPA / Hibernate 的 JpaDialect（如 HibernateJpaDialect）受限於 JPA 規範與底層實現機制，不支持創建 Savepoint。在 JPA 環境下設定 Propagation.NESTED 時，Spring 會直接拋出 TransactionSystemException: JpaDialect does not support savepoints。

Issue & Env（案發現場與環境）

運行環境

Spring Boot 2.7.x / 3.x
Spring Data JPA + Hibernate
關係型數據庫：MySQL 8.0+ / PostgreSQL 14+（底層引擎均支持 SAVEPOINT）

業務場景

電商系統創建訂單主流程中包含贈送積分等次級邏輯。開發者期望積分贈送失敗時不阻斷主流程（即訂單照常生成，僅將積分相關操作回滾），由於不想支付 REQUIRES_NEW 掛起外層連接與另起新物理連接的開銷，選擇了 Propagation.NESTED。

事務傳播對比與失效特徵

REQUIRED：加入當前事務，共享提交點，無法做到局部隔離回滾。
REQUIRES_NEW：開闢全新物理連接與事務，內層回滾獨立，但外層被掛起且佔有兩條數據庫連接。
NESTED：在同一個底層物理連接內設定 SAVEPOINT。內層報錯僅回退到該保存點，外層繼續執行。

在純 JDBC 或 MyBatis 環境下此邏輯可正常工作；但在 Spring Data JPA（Hibernate）環境下，調用帶有 NESTED 註解的 Service 方法時，直接在運行時拋出系統例外。

StackTrace（堆疊日誌）

運行時觸發嵌套事務調用時輸出的關鍵堆疊如下：

org.springframework.transaction.TransactionSystemException: Could not commit JPA transaction; nested exception is javax.persistence.PersistenceException: org.hibernate.TransactionException: JpaDialect does not support savepoints: org.springframework.orm.jpa.vendor.HibernateJpaDialect
	at org.springframework.orm.jpa.JpaTransactionManager.doBegin(JpaTransactionManager.java:446)
	at org.springframework.transaction.support.AbstractPlatformTransactionManager.handleExistingTransaction(AbstractPlatformTransactionManager.java:479)
	at org.springframework.transaction.support.AbstractPlatformTransactionManager.getTransaction(AbstractPlatformTransactionManager.java:352)
	at org.springframework.transaction.interceptor.TransactionAspectSupport.createTransactionIfNecessary(TransactionAspectSupport.java:595)
	at org.springframework.transaction.interceptor.TransactionAspectSupport.invokeWithinTransaction(TransactionAspectSupport.java:382)
	at org.springframework.transaction.interceptor.TransactionInterceptor.invoke(TransactionInterceptor.java:119)
	at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
	at org.springframework.aop.framework.CglibAopProxy$CglibMethodInvocation.proceed(CglibAopProxy.java:763)
Caused by: javax.persistence.PersistenceException: org.hibernate.TransactionException: JpaDialect does not support savepoints: org.springframework.orm.jpa.vendor.HibernateJpaDialect
	at org.hibernate.internal.ExceptionConverterImpl.convert(ExceptionConverterImpl.java:154)
	at org.hibernate.internal.ExceptionConverterImpl.convert(ExceptionConverterImpl.java:181)
	at org.hibernate.internal.ExceptionConverterImpl.convert(ExceptionConverterImpl.java:188)
Caused by: org.hibernate.TransactionException: JpaDialect does not support savepoints: org.springframework.orm.jpa.vendor.HibernateJpaDialect
	at org.springframework.orm.jpa.vendor.HibernateJpaDialect.beginTransaction(HibernateJpaDialect.java:185)

日誌特徵排查要點：

頂層拋出 TransactionSystemException。
Caused by 出現 JpaDialect does not support savepoints: org.springframework.orm.jpa.vendor.HibernateJpaDialect。
表明當前事務管理器類型為 JpaTransactionManager，而非純 JDBC 的 DataSourceTransactionManager。

Reproduce（復現程式碼）

以下是誘發該例外的典型業務復現結構：

@Service
public class OrderService {

    @Autowired
    private OrderRepository orderRepository;

    @Autowired
    private PointService pointService;

    @Transactional
    public void createOrder(Order order) {
        orderRepository.save(order);
        try {
            // 开发者试图通过 NESTED 实现局部保存点回滚
            pointService.giftPoints(order.getUserId(), 100);
        } catch (Exception e) {
            // 期望捕获异常后不影响 orderRepository 的正常落库
        }
    }
}

@Service
public class PointService {

    @Autowired
    private PointRecordRepository pointRecordRepository;

    // 错误配置：在 JPA 环境下使用了 NESTED 传播行为
    @Transactional(propagation = Propagation.NESTED)
    public void giftPoints(Long userId, int point) {
        pointRecordRepository.save(new PointRecord(userId, point));
    }
}

Root Cause（根因分析）

1. Spring 保存點抽象機制與 JPA 適配斷層

Spring 在 AbstractPlatformTransactionManager 中處理 Propagation.NESTED 時，核心分支邏輯如下：

// AbstractPlatformTransactionManager.java 核心逻辑示意
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NESTED) {
    if (useSavepointForNestedTransaction()) {
        // 创建 JDBC 保存点
        DefaultTransactionStatus status = prepareTransactionStatus(...);
        status.createAndHoldSavepoint();
        return status;
    } else {
        // 嵌套事务作为新物理事务处理（仅 JTA 环境）
        return startTransaction(definition, transaction, debugEnabled, suspendedResources);
    }
}

在基於 JDBC 的 DataSourceTransactionManager 中，status.createAndHoldSavepoint() 通過原生 JDBC API java.sql.Connection.setSavepoint() 設置保存點，完全由驅動與數據庫支撐。

然而在 Spring Data JPA 環境下，事務管理器使用的是 JpaTransactionManager。Spring 將保存點操作委託給底層 JpaDialect（通常是 HibernateJpaDialect）。JPA 規範本身沒有關於 JDBC Savepoint 的標準化概念，Hibernate 的 Session 級事務機制並不對外暴露或者橋接 Savepoint 控制。當檢查 supportsSavepoints() 時，HibernateJpaDialect 明確返回 false，從而直接拋出 NestedTransactionNotSupportedException 或 TransactionSystemException。

2. 快速排查與定位手段

在程式碼庫中檢索事務傳播屬性和事務管理器設定：

# 1. 查找所有使用了 NESTED 的业务方法
grep -rn "Propagation.NESTED" src/main/java

# 2. 检查当前工程配置的事务管理器是否为 JpaTransactionManager
grep -rn "JpaTransactionManager\|DataSourceTransactionManager" src/main/java

The Fix（解決方案）

針對 JPA 環境不支持 NESTED 保存點的問題，根據業務一致性要求選擇以下修復方案：

方案 A（推薦）：將邏輯轉為全原子性操作，統一使用 `REQUIRED`

如果業務允許在積分失敗時整體回滾訂單，則去除 NESTED 和 try-catch，保持強一致性：

@Service
public class PointService {

    @Transactional(propagation = Propagation.REQUIRED)
    public void giftPoints(Long userId, int point) {
        pointRecordRepository.save(new PointRecord(userId, point));
    }
}

方案 B：確需“子操作失敗不影響外層” → 改用 `REQUIRES_NEW`

當次級操作為弱依賴邏輯（如日誌打點、失敗可容忍的積分預贈），改用獨立事務與獨立數據庫連接：

@Service
public class PointService {

    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void giftPoints(Long userId, int point) {
        pointRecordRepository.save(new PointRecord(userId, point));
    }
}

注意：REQUIRES_NEW 具有獨立提交特性，子事務一旦 commit 便不受外層事務回滾的影響；同時會掛起外層事務連接，需注意數據庫連接池的併發容量。

方案 C：持久層重構為原生 JDBC / MyBatis，使用 `DataSourceTransactionManager`

如果業務架構強依賴數據庫底層 SAVEPOINT 級別的高頻局部回滾，必須更換持久層與事務管理器為純 JDBC 實現：

@Configuration
public class TransactionConfig {

    @Bean
    public PlatformTransactionManager transactionManager(DataSource dataSource) {
        // DataSourceTransactionManager 原生支持 Connection.setSavepoint()
        return new DataSourceTransactionManager(dataSource);
    }
}

總結與避坑要點

JPA 不支持保存點：在 Spring Boot JPA 環境下，切勿使用 Propagation.NESTED，HibernateJpaDialect 無法提供保存點支持。
語義區分：NESTED 依託保存點，外層回滾連帶內層回滾，內層回滾不影響外層；REQUIRES_NEW 擁有獨立連接與生命週期，兩者機制完全不同。
技術棧遷移審計：從 MyBatis/JDBC 遷移至 JPA/Hibernate 時，必須全局搜索 Propagation.NESTED 並統一進行策略調整。

References（參考來源）

Spring Framework Docs: Transaction propagation NESTEDdocs
Spring NESTED 事務在 JPA 下的坑stackoverflow