Java 后端 / 系统课时

处理 UnexpectedRollbackException

处理 UnexpectedRollbackException

本课解决一个典型的 Spring 事务陷阱:内层方法捕获异常并继续返回,外层方法看起来执行成功,却在最终提交时收到 UnexpectedRollbackException。关键是理解共享事务中的 rollback-only 标记如何一路影响最外层提交。

学习目标

  • 理解默认 REQUIRED 下嵌套调用共享同一个物理事务的关系
  • 定位 UnexpectedRollbackException 出现在提交阶段的原因
  • 区分方法调用嵌套、REQUIRED 和真正的 NESTED/REQUIRES_NEW

异常为什么会延迟到外层提交时出现

默认情况下,两个都标注 @Transactional 且使用 PROPAGATION_REQUIRED 的方法,如果发生调用嵌套,通常加入同一个物理事务。内层方法虽然可以捕获自己的异常,但如果当前事务已经被标记为 rollback-only,这个标记不会因为 catch 而自动清除。

因此可能出现这样的控制流:内层失败 → 当前事务被标记为不可提交 → 内层 catch 后正常返回 → 外层继续执行 → 外层方法正常返回 → 事务管理器尝试提交 → 发现 rollback-only → 抛出 UnexpectedRollbackException。

UnexpectedRollbackException 的回滚标记传播路径

用两个服务重现问题

下面是核心片段。把事务方法放在两个不同的 Spring Bean 中,是为了确保外层调用能够经过 Spring 事务代理;不要把它直接改成同一个类里的自调用,否则可能绕过代理。

java
@Service
public class InnerService {

    @Transactional
    public void writeAudit() {
        try {
            repository.saveAudit();
            throw new IllegalStateException("audit failed");
        } catch (RuntimeException ex) {
            log.warn("audit rejected", ex);
            // 业务决定吞掉异常,但当前共享事务已经不能提交
            TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
        }
    }
}

@Service
public class OuterService {

    private final InnerService innerService;
    private final OrderRepository repository;

    public OuterService(InnerService innerService, OrderRepository repository) {
        this.innerService = innerService;
        this.repository = repository;
    }

    @Transactional
    public void createOrder() {
        repository.saveOrder();
        innerService.writeAudit();
        repository.saveStatus("READY");
    }
}

这是片段示例,依赖 Spring Boot、事务管理器、OrderRepository 和日志对象。这里没有配置新的传播级别,因此使用默认 REQUIRED:内外层加入同一个物理事务。

预期结果

text
createOrder() 在业务代码层面可以执行到最后,但外层事务提交时发现 rollback-only,事务回滚并抛出 UnexpectedRollbackException。

UnexpectedRollbackException 的重点在“Unexpected”。外层代码并没有直接看到一个正在向上冒泡的原始异常,却在提交阶段发现:这个事务早已被内部参与者标记为只能回滚。Spring 用这个异常明确告诉调用方,不能把这次方法调用当成一次成功提交。

真正要检查的是传播属性

排查这类问题时,先确认被调用方法是否加入了外层事务。最常见的是 REQUIRED:内层方法加入现有事务,因此内层设置的 rollback-only 会影响整个物理事务。

REQUIRES_NEW 会挂起外层事务并创建独立事务。此时内层回滚通常只影响内层事务,外层仍有机会继续提交,但要注意外层与内层已经不是同一个事务。

NESTED 则依赖事务管理器和底层资源对嵌套事务的支持,通常以保存点实现局部回滚。它与“两个 @Transactional 方法调用嵌套”不是一回事,不能看到方法嵌套就直接认定使用了 NESTED。

排查时沿着这条证据链走

遇到 UnexpectedRollbackException,不要只搜索最外层堆栈。优先回查同一事务中的调用链:哪个内部方法发生过异常、哪个地方捕获了异常、是否调用了 setRollbackOnly()、使用的传播级别是什么,以及最终提交由哪个事务边界负责。

还要检查代理边界。事务注解依赖 Spring 的代理机制生效,同一个类内部直接调用另一个 @Transactional 方法时,常见情况下不会重新经过代理,因此传播行为和你阅读源码时看到的注解可能并不一致。

修复策略应与业务语义一致

如果内层失败代表整个业务操作都不能成功,就不要吞掉异常再继续假装成功;让异常明确离开事务边界,通常更容易维护。

如果内层失败应该独立回滚、外层仍可继续,就要认真评估是否需要 REQUIRES_NEW 或合适的嵌套事务设计,而不是简单地捕获异常。传播级别改变的是事务边界,必须同时重新检查锁、连接和一致性语义。

当业务确实需要“返回失败结果但整体回滚”时,可以显式使用 setRollbackOnly(),并让调用方明确知道最终结果可能在提交阶段失败。这样才能把“业务返回值”和“事务提交结果”设计成一致的契约。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

处理 UnexpectedRollbackException

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通