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