Java 后端 / 系统课时
处理 UnexpectedRollbackException
处理 UnexpectedRollbackException
本课解决一个典型的 Spring 事务陷阱:内层方法捕获异常并继续返回,外层方法看起来执行成功,却在最终提交时收到 UnexpectedRollbackException。关键是理解共享事务中的 rollback-only 标记如何一路影响最外层提交。
学习目标
- 理解默认
REQUIRED下嵌套调用共享同一个物理事务的关系 - 定位
UnexpectedRollbackException出现在提交阶段的原因 - 区分方法调用嵌套、
REQUIRED和真正的NESTED/REQUIRES_NEW
异常为什么会延迟到外层提交时出现
默认情况下,两个都标注 @Transactional 且使用 PROPAGATION_REQUIRED 的方法,如果发生调用嵌套,通常加入同一个物理事务。内层方法虽然可以捕获自己的异常,但如果当前事务已经被标记为 rollback-only,这个标记不会因为 catch 而自动清除。
因此可能出现这样的控制流:内层失败 → 当前事务被标记为不可提交 → 内层 catch 后正常返回 → 外层继续执行 → 外层方法正常返回 → 事务管理器尝试提交 → 发现 rollback-only → 抛出 UnexpectedRollbackException。

用两个服务重现问题
下面是核心片段。把事务方法放在两个不同的 Spring Bean 中,是为了确保外层调用能够经过 Spring 事务代理;不要把它直接改成同一个类里的自调用,否则可能绕过代理。
@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:内外层加入同一个物理事务。
预期结果
createOrder() 在业务代码层面可以执行到最后,但外层事务提交时发现 rollback-only,事务回滚并抛出 UnexpectedRollbackException。UnexpectedRollbackException 的重点在“Unexpected”。外层代码并没有直接看到一个正在向上冒泡的原始异常,却在提交阶段发现:这个事务早已被内部参与者标记为只能回滚。Spring 用这个异常明确告诉调用方,不能把这次方法调用当成一次成功提交。
真正要检查的是传播属性
排查这类问题时,先确认被调用方法是否加入了外层事务。最常见的是 REQUIRED:内层方法加入现有事务,因此内层设置的 rollback-only 会影响整个物理事务。
REQUIRES_NEW 会挂起外层事务并创建独立事务。此时内层回滚通常只影响内层事务,外层仍有机会继续提交,但要注意外层与内层已经不是同一个事务。
NESTED 则依赖事务管理器和底层资源对嵌套事务的支持,通常以保存点实现局部回滚。它与“两个 @Transactional 方法调用嵌套”不是一回事,不能看到方法嵌套就直接认定使用了 NESTED。
排查时沿着这条证据链走
遇到 UnexpectedRollbackException,不要只搜索最外层堆栈。优先回查同一事务中的调用链:哪个内部方法发生过异常、哪个地方捕获了异常、是否调用了 setRollbackOnly()、使用的传播级别是什么,以及最终提交由哪个事务边界负责。
还要检查代理边界。事务注解依赖 Spring 的代理机制生效,同一个类内部直接调用另一个 @Transactional 方法时,常见情况下不会重新经过代理,因此传播行为和你阅读源码时看到的注解可能并不一致。
修复策略应与业务语义一致
如果内层失败代表整个业务操作都不能成功,就不要吞掉异常再继续假装成功;让异常明确离开事务边界,通常更容易维护。
如果内层失败应该独立回滚、外层仍可继续,就要认真评估是否需要 REQUIRES_NEW 或合适的嵌套事务设计,而不是简单地捕获异常。传播级别改变的是事务边界,必须同时重新检查锁、连接和一致性语义。
当业务确实需要“返回失败结果但整体回滚”时,可以显式使用 setRollbackOnly(),并让调用方明确知道最终结果可能在提交阶段失败。这样才能把“业务返回值”和“事务提交结果”设计成一致的契约。