外观
13 - Spring 事务为什么没有回滚:一份从代理到数据库的排查手册
适用版本:Spring Framework 6.x、Spring Boot 3.x。
前置阅读:10 - 同类调用为什么绕过 AOP、11 - Spring 声明式事务执行链和12 - 事务传播行为。本文先建立排查所需的基本模型,再把故障现象对应到具体检查点。
摘要
方法标了 @Transactional,日志也记录了异常,数据却仍然存在,原因未必是注解失效。异常可能在方法内部被捕获,SQL 可能使用了另一个数据源,也可能是数据库已提交、后续通知才失败。排查时应沿调用路径逐层确认,而不是只看注解和异常日志。
本文以 Spring 默认代理模式下的命令式 JDBC/JPA 本地事务为主要模型。命令式事务通过普通方法调用执行;JDBC 是 Java 访问数据库的接口,JPA 是 Java 持久化 API。本地事务由一个数据库资源完成提交或回滚,不能直接用来推断跨系统事务的结果。响应式事务使用另一套上下文机制,也不能直接套用下文的线程绑定规则。
1. 先定义“没有回滚”是哪一种
- 根本没有开启事务;
- 开启了事务,但异常不满足回滚规则;
- 异常被捕获,方法正常返回;
- 事务回滚了,但另一个数据源已经提交;
- 数据库操作不支持或未加入当前事务;
- 外部副作用无法随数据库事务回滚。
先确定没有撤销的是哪一条 SQL、哪个数据源上的修改,还是消息、支付等外部动作。同一个请求中的这些操作,不一定属于同一个事务。
2. 六层排查模型
@Transactional 声明事务要求,本身不执行数据库回滚。在代理模式下,调用先经过代理对象;代理在业务方法外围执行事务拦截器。拦截器读取事务配置,委托事务管理器准备事务,再调用业务方法。方法退出后,拦截器根据返回结果、异常规则和事务状态请求提交或回滚,事务管理器负责操作底层资源。
因此要分清三个边界:调用是否进入事务拦截器,SQL 是否使用该事务控制的资源,以及数据库是否真正完成提交或回滚。方法正常返回,只说明业务代码执行到了返回位置;它不等于数据库已经提交成功。
图表将在阅读到此处时加载…
第一层:对象来源
Spring Bean 是由容器管理的对象,但受容器管理也不等于一定包含事务增强。直接 new、非 Spring 管理对象、测试中手工构造的对象都不会自动获得事务代理。先检查调用方实际持有的对象,而不是只查看目标类上的注解。
第二层:调用路径
同类自调用指一个对象内部直接调用自己的另一个方法。这条调用路径不会重新进入当前 Spring 代理,因此内层方法的事务配置不会形成新的代理事务边界;如果外层已有事务,内层数据库操作仍可能参与外层事务。
方法能否被拦截,还要结合代理策略和事务配置检查。JDK 代理通过接口暴露调用,基于类的代理通过子类增强方法;private、final、接口未暴露等情况不能用同一句口诀判断。也不要用“事务方法必须 public”覆盖所有 Spring 6 场景,应验证当前方法是否匹配事务 Advisor。Advisor 把增强逻辑与适用方法关联起来;存在代理,并不能证明目标调用会执行事务增强。
第三层:事务属性
确认目标方法实际解析出的 @Transactional 配置,包括事务管理器、传播行为、回滚规则和只读标记。事务管理器决定控制哪个资源;传播行为决定进入方法时是加入已有事务、另开事务,还是非事务执行。注解生效也不代表一定新建数据库事务。
第四层:异常规则
默认回滚规则通常对 RuntimeException(运行时异常)和 Error 回滚;checked exception(受检异常,即编译器要求捕获或声明的异常)需要明确配置回滚规则。应检查最终越过事务方法边界的异常类型,而不是只看最初发生的异常。
异常在方法内被 catch 后正常返回,拦截器就无法根据这次异常应用回滚规则。不过,正常返回也不能保证提交:事务可能已被底层资源或其他参与者标记为仅回滚(rollback-only),即最终只能回滚,不能提交。第 3 节进一步区分这两条路径。
第五层:资源参与
DataSource 是 JDBC 获取数据库连接的入口。事务管理器控制一个数据源,并不意味着所有连接上的 SQL 都自动加入该事务。多数据源、手工连接、错误的 DataSource 或非事务表,都可能使 SQL 脱离当前事务。应核对数据访问实际使用的连接及其来源;“当前线程有事务”不足以证明目标 SQL 会一起回滚。
第六层:完成结果
使用 ORM(对象关系映射框架)时,实体修改可能先保存在持久化上下文中;Flush 是把这些待处理修改同步到数据库的过程,并不等于提交。事务同步回调是在提交前、提交后或事务完成时执行的附加逻辑。
业务方法正常返回后,仍可能在 Flush、同步回调或数据库 COMMIT(提交)时失败;回滚本身也可能因连接故障抛出异常。日志中的“业务成功”与“数据库提交成功”应分别判断:
- 根本没有开启事务;
- 事务决定提交;
- 已尝试提交但提交失败;
- 已决定回滚但回滚失败;
- 本地数据库已提交,但响应或外部通知失败。
3. 反例:吞掉异常
下面是方法片段,省略类定义、导入以及 repository、log 的依赖配置。假设调用经过事务代理,两次保存操作使用同一事务管理器控制的资源:
java
@Transactional
public void createOrder() {
try {
repository.saveOrder();
repository.saveItems();
} catch (Exception e) {
log.error("create failed", e);
// 方法正常返回,事务拦截器通常会尝试提交
}
}如果 saveOrder() 已写入数据,随后 saveItems() 抛出异常,而异常被此处的 catch 捕获,拦截器看到的仍是正常返回。在事务没有被标记为仅回滚、提交阶段也没有失败的前提下,预期结果是尝试提交已有修改,而不是自动撤销订单。
若业务要求两步共同成功或失败,应让满足回滚规则的异常传播出事务方法;确有必要捕获时,可以显式设置 rollback-only。显式标记会让业务代码依赖 Spring 事务 API,应谨慎使用。
还要区分“在当前方法内捕获异常”和“捕获另一个事务代理抛出的异常”。例如,另一个 Bean 的方法以 REQUIRED 加入同一事务,异常先越过内层代理时,共享事务可能已被标记为仅回滚。外层再捕获异常不会清除这个状态,提交时仍可能出现 UnexpectedRollbackException,表示请求提交却遇到了必须回滚的事务。具体过程见12 - 事务传播行为。
还要确认异常类型和最终抛出对象。业务异常可能被包装,rollbackFor 按类型层次匹配;如果代码将异常转换为正常返回值,事务拦截器看到的仍是成功返回。
4. 外部调用无法由本地事务回滚
text
数据库写入 -> 调用支付接口 -> 发送消息这条业务调用链不等于一个共同的事务。数据库回滚只能撤销其事务范围内的数据库修改,不能撤销已经成功的 HTTP 调用,也不能自动收回已发送的消息。
跨系统一致性需要按业务选择 Outbox、可靠消息、幂等和补偿等方案。Outbox 指在业务事务中写入待发送事件,再由后续流程投递;幂等指同一业务请求重复执行不会产生重复效果;补偿则通过后续业务动作处理已发生的结果,例如撤销或退款。它们解决的问题不同,不能靠扩大 @Transactional 方法统一替代。
对应方案见分布式 29 - Transactional Outbox 与 CDC。如果外部动作不可撤销,还应设计业务幂等键和补偿状态,而不是只增加数据库事务传播层级。
5. 只读事务的边界
readOnly = true 通常是给事务管理器、ORM 或数据库的优化提示,不应把它当成绝对写保护。实际行为受持久化框架、驱动和数据库影响,必须在目标技术栈验证。因此,“只读事务内写入没有报错”不能单独证明事务未生效,也不能据此认定所有环境都允许写入。
6. 可观察性
可观察性是通过日志、指标和数据库状态还原执行过程的能力。Spring Boot 排障环境可临时使用下面的日志配置片段:
yaml
logging:
level:
org.springframework.transaction.interceptor: TRACE
org.springframework.jdbc.datasource.DataSourceTransactionManager: DEBUG具体类名取决于使用 JDBC、JPA 还是其他事务管理器。生产开启 TRACE 前要评估日志量和敏感信息风险。
建议为一次故障建立以下证据表:
| 证据 | 要回答的问题 |
|---|---|
| Bean 类型与 Advisor | 对象是否为事务代理,目标方法是否匹配 |
| 事务 TRACE 日志 | 创建、参与、挂起、提交或回滚发生在哪一步 |
| DataSource/连接池指标 | 使用了哪个池,是否等待或拿到错误数据源 |
| 数据库会话与事务视图 | SQL 是否处于事务中,隔离级别和锁等待是什么 |
| 应用异常链 | 哪个异常越过代理,是否在提交阶段被重新包装 |
| 最终数据与外部副作用 | 数据库、消息、缓存和 HTTP 各自成功了什么 |
6.1 多数据源必须证明“管理器—资源”对应
仅打印事务 active(当前事务处于活动状态)不足以证明目标 SQL 加入了预期事务。应记录或检查:
text
事务方法
→ 选中的 PlatformTransactionManager
→ 该管理器控制的 DataSource / EntityManagerFactory
→ Repository 实际使用的数据源这里的 PlatformTransactionManager 是命令式事务管理接口,EntityManagerFactory 是创建 JPA 实体管理器的工厂,Repository 指执行数据访问的组件。如果事务管理器控制数据源 A,而 Repository 使用数据源 B,方法可以处于“有事务”状态,但 B 上的 SQL 仍可能自动提交或进入另一事务。自动提交意味着数据库把每条语句各自作为事务完成,因此回滚 A 不能撤销 B 已提交的修改。
6.2 跨线程问题先记录线程边界
为事务入口和异步任务记录线程名、Trace ID(关联同一次请求的追踪标识)与事务 active 状态。命令式事务资源通常绑定当前线程,新线程不会自动继承这些资源,也不应手工复制连接。即使 Trace ID 被传到了异步任务,也只能说明日志可以关联,不能证明 SQL 属于同一个事务。异步 SQL 应单独确认其事务入口和资源。原理见并发 21 - 并发上下文传播与 ScopedValue。
7. 容易踩的坑
前面的六层模型之外,测试和观察方式也可能制造误判:
- 测试自身带事务:测试结束后的自动回滚可能掩盖被测方法的生产提交行为。应确认事务由谁开启、由哪个边界完成。
- 观察时机不对:业务方法返回之后,Flush、提交或回滚仍可能失败。应保留完整异常链,并记录失败阶段。
- 验证环境不同:内存数据库上的结果不能直接证明生产 MySQL 的事务行为。引擎、驱动、锁和隔离级别差异都需要核对。
8. 现场排查清单
- 打印实际 Bean 类型,确认事务代理存在。
- 画出调用者到事务方法的真实路径。
- 确认事务管理器与 DataSource 对应关系。
- 查看异常最终是否逃出代理边界。
- 检查 SQL 使用的连接是否绑定当前事务。
- 核对数据库引擎、隔离级别和自动提交配置。
- 把消息、缓存和 HTTP 等外部副作用单独分析。
- 确认异常发生在业务执行、Flush、提交还是回滚阶段。
- 用独立连接查询最终数据,避免当前事务快照或测试回滚干扰结论。
9. 从现象选择下一步
| 现象 | 优先检查 | 深入阅读 |
|---|---|---|
| 注解完全没有进入 | 对象来源、调用路径、Advisor | 10 - 同类调用与 AOP 失效 |
| 捕获异常后提交时报错 | rollback-only、传播行为 | 12 - 事务传播行为 |
| SQL 阻塞或死锁 | 数据库会话、锁对象、访问顺序 | 数据库 19 - SELECT 与锁、数据库 20 - 死锁定位 |
| 数据库回滚但消息已发 | 本地事务边界、事件投递协议 | 分布式 29 - Outbox 与 CDC |
| 异步 SQL 独立提交 | 线程切换与子任务事务 | 并发 21 - 上下文传播 |
| 一部分数据源回滚、一部分提交 | 事务管理器与资源映射 | 本文 6.1 |
10. 总结
事务排障必须从代理入口一直验证到底层资源,注解存在只是起点。
- 先证明调用进入事务拦截器,再讨论回滚规则。
- 异常是否传播决定拦截器看到的是成功还是失败。
- 本地数据库事务无法自动覆盖跨线程、跨数据源和外部系统副作用。
阅读导航
- 代理边界:10 - 同类调用为什么绕过 AOP
- 执行机制:11 - Spring 声明式事务执行链
- 传播与连接占用:12 - 事务传播行为
- 数据库正确性:数据库 16 - ACID 的工程含义
- 数据库锁和死锁:数据库 19 - SELECT 与锁、数据库 20 - 死锁定位与修复
- 跨系统一致性:分布式 29 - Outbox 与 CDC
- 全链路故障分诊:20 - Spring 线上问题排查手册