Java 后端 / 技术文章

Spring @Transactional 为什么不回滚

线上遇到“方法明明抛异常,数据库却留下了部分数据”时,最容易误判的是 @Transactional 本身失效;实际上,问题可能发生在代理没有生效、异常没有传播到事务代理、事务已经被标记为 rollback-only、数据源不在同一个事务里,甚至代码已经跨出了原事务边界。本文面向负责排查 Spring 事务问题的 Java 后端工程师,给出一条从现象到证据的排查路径,最终能够判断问题发生在哪一层,而不是反复修改注解参数。

先确认:真的“不回滚”还是观察方式有误

第一步不要急着改 rollbackFor。先回答三个问题:异常发生在哪个方法、异常发生后调用链是否返回到事务代理、数据库最终看到的记录来自哪个连接和事务。

一个最小验证案例可以直接观察“写入 → 异常 → 方法退出 → 数据库结果”:

java
@Service
public class OrderService {

    private final OrderRepository repository;

    public OrderService(OrderRepository repository) {
        this.repository = repository;
    }

    @Transactional
    public void createOrder() {
        repository.insertOrder("order-1");
        repository.insertOrder("order-2");
        throw new RuntimeException("simulate rollback");
    }
}

调用后应检查数据库中 order-1 和 order-2 是否都不存在,而不是只看接口是否返回 500。

预期结果:

text
请求返回异常
数据库中本次事务产生的两条记录均不存在

如果异常已经明确抛出,但数据仍然存在,就继续按下面的顺序缩小范围。

第一关:确认调用真的经过 Spring 事务代理

@Transactional 是声明式事务,它依赖 Spring 对目标 Bean 的代理拦截。最常见的问题不是注解写错,而是调用路径根本没有经过代理。

优先检查以下几种情况:

检查项 典型问题 排查重点
Bean 来源 对象通过 new 创建 是否由 Spring 容器管理
调用方式 同类内部 this.xxx() 是否绕过代理
方法可代理性 方法定义不符合当前代理方式 检查代理配置与方法边界
Bean 类型 依赖注入拿到的不是预期代理对象 检查运行时类型
代理配置 AOP/事务相关配置未生效 检查实际应用配置

可以在关键位置打印运行时对象类型和事务状态:

java
import org.springframework.aop.support.AopUtils;
import org.springframework.transaction.support.TransactionSynchronizationManager;

Object target = orderService;
System.out.println("beanClass=" + target.getClass().getName());
System.out.println("isAopProxy=" + AopUtils.isAopProxy(target));
System.out.println("txActive=" + TransactionSynchronizationManager.isActualTransactionActive());

预期结果:

text
isAopProxy=true
txActive=true

这里要注意,isAopProxy=true 只能证明对象被 AOP 代理,并不能单独证明当前调用已经进入事务;真正有价值的是同时观察 txActive、调用路径和事务日志。

第二关:确认异常真的让事务代理看到

“代码里抛了异常”不等于“事务会回滚”。事务是否回滚,取决于异常有没有沿着事务边界传播到事务拦截逻辑,以及异常类型是否匹配当前回滚规则。

最典型的误区是自己捕获异常后直接返回:

java
@Transactional
public void createOrder() {
    repository.insertOrder("order-1");

    try {
        repository.insertOrder("order-2");
        throw new IllegalStateException("business failure");
    } catch (IllegalStateException ex) {
        log.error("create order failed", ex);
    }
}

方法最终正常返回时,事务代理看到的是“方法正常结束”。此时不能只盯着 throw 那一行,而要继续确认:异常是否被捕获、是否重新抛出、事务是否已经被其他逻辑标记为不可提交。

排查时至少记录这四个事实:异常具体类型、是否被 catch、是否再次抛出、方法最终是正常返回还是异常返回。

预期结果:

text
异常类型:IllegalStateException
异常是否到达事务边界:是 / 否
方法最终返回:正常 / 异常
事务最终状态:commit / rollback / rollback-only

特别是已经了解 Spring 默认回滚规则的团队,不要把“指定 rollbackFor”当成所有问题的万能修复。若异常根本没有到达事务边界,调整回滚规则不会解决代理链路问题。

第三关:检查事务是否已经进入 rollback-only

还有一种高频场景:内层业务失败时异常被处理了,但共享事务已经被标记为 rollback-only。外层方法继续执行,最终提交阶段才暴露问题。

这时日志可能会出现类似 UnexpectedRollbackException 的现象。排查重点不是“最后为什么没提交”,而是“谁最先把当前事务标记成不可提交”。

可以在关键调用前后观察事务状态:

java
import org.springframework.transaction.support.TransactionAspectSupport;
import org.springframework.transaction.support.TransactionSynchronizationManager;

System.out.println("active=" + TransactionSynchronizationManager.isActualTransactionActive());
System.out.println("readOnly=" + TransactionSynchronizationManager.isCurrentTransactionReadOnly());

try {
    innerService.execute();
} catch (RuntimeException ex) {
    log.error("inner failed", ex);
}

System.out.println("rollbackOnly=" + TransactionAspectSupport.currentTransactionStatus().isRollbackOnly());

预期结果:

text
active=true
readOnly=false
rollbackOnly=true

如果这里已经是 true,说明后续即使业务代码继续运行,也不能再把当前物理事务当成一个可以正常提交的事务。此时应沿调用链反查第一个失败点,而不是继续修改最外层方法的注解。

第四关:确认所有数据库写入真的在同一个事务资源里

事务边界正确、异常传播也正确,仍然可能出现“部分数据没有回滚”。这时要怀疑写操作是不是用了不同的数据源、不同的连接,或者某些操作实际上已经脱离当前事务。

重点核对:

证据 要确认什么
数据源配置 写入是否来自同一个 DataSource
事务管理器 @Transactional 使用的事务管理器是否正确
Repository/Mapper 是否存在不同数据源或独立连接
手工连接 是否自行开启、提交或关闭连接
外部系统 是否把消息、HTTP、异步任务误认为数据库事务的一部分

可以先用日志确认事务上下文是否存在,再结合 SQL 日志观察实际连接和提交时机。不要只根据“两个 SQL 都执行成功”判断它们属于同一个事务。

预期结果:

text
写入 SQL 1:事务 T1
写入 SQL 2:事务 T1
业务异常:RuntimeException
事务结束:ROLLBACK T1
数据库:两次写入均不可见

若日志显示两个写操作使用了不同的事务上下文,就应该回到数据源和事务管理器配置继续定位。

第五关:排查跨线程、异步和事务边界外的调用

事务上下文通常绑定当前执行线程。一个方法进入事务,并不意味着它启动的异步任务自动加入同一个事务。

例如:

java
@Transactional
public void createOrder() {
    repository.insertOrder("order-1");
    asyncService.sendNotification();
    throw new RuntimeException("simulate rollback");
}

如果 sendNotification() 通过异步执行,它不能因为调用发生在事务方法内部,就自然获得与外层方法相同的事务上下文。此时要把“数据库事务”和“异步任务”拆开观察。

排查跨线程问题时,重点记录线程名、事务激活状态、事务同步状态,以及异步任务真正执行的时间点。

预期结果:

text
主线程:txActive=true
异步线程:txActive=false

如果业务要求异步任务在主事务提交后执行,应明确设计提交后的事件或独立事务边界,而不是依赖线程切换后继续复用原事务。

第六关:建立一条固定的事务诊断路径

线上排查最怕“哪里可疑就改哪里”。更稳定的方法是固定证据顺序:先确认调用对象,再确认事务是否激活,再确认异常传播,再确认 rollback-only,最后确认数据库资源。

可以把一次故障压缩成下面的判断链:

text
接口异常
  ↓
是否进入 Spring 代理?
  ├─ 否 → 排查 Bean 来源、自调用、代理配置
  └─ 是
      ↓
事务是否激活?
  ├─ 否 → 排查事务注解作用范围与调用边界
  └─ 是
      ↓
异常是否传播到事务边界?
  ├─ 否 → 排查 catch、返回值与异常转换
  └─ 是
      ↓
事务是否已 rollback-only?
  ├─ 是 → 追查最早标记点与内层事务异常
  └─ 否
      ↓
所有写入是否属于同一事务资源?
  ├─ 否 → 排查 DataSource、事务管理器、独立连接
  └─ 是 → 检查提交日志、数据库结果与最终边界

建议把以下字段作为线上事务问题的最小证据集:请求标识、线程名、目标 Bean 类型、事务是否激活、事务只读状态、异常完整堆栈、事务最终状态、关键 SQL 及提交或回滚记录。

完成这套检查后,就能把“@Transactional 不回滚”进一步收敛为代理未进入、异常未传播、事务已标记回滚、事务资源不一致或跨线程脱离边界中的具体问题。

目录与阅读设置

记录一个想法

Spring @Transactional 为什么不回滚

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

登录哪都通