外观
11 - @Transactional 的开启、提交与回滚:Spring 声明式事务执行链
适用版本:Spring Framework 6.x。数据库行为仍取决于驱动、连接池、数据库及事务管理器。
前置阅读:09 - Spring AOP 如何创建代理和10 - 同类调用为什么绕过 AOP。数据库原子性与并发控制见数据库 16 - ACID 的工程含义。
摘要
@Transactional 声明方法需要怎样的事务,例如是否加入已有事务、哪些异常需要回滚。它本身不操作数据库。在 Spring 默认的代理模式下,调用先经过代理,由事务拦截器在业务方法执行前准备事务,在方法退出后请求提交或回滚,最后由事务管理器处理底层资源。
理解这条执行链,才能区分“方法执行成功”“异常被记录”和“数据库事务提交成功”。本文先介绍命令式事务的基本模型,再解释连接共享、回滚规则和验证方法。
1. 场景:日志抛异常,数据为什么仍提交
假设一个事务方法先写数据库,再执行日志记录;日志记录操作抛出异常,业务代码捕获异常后正常返回。此时事务拦截器看到的是“方法正常返回”,不会仅因日志中出现异常就按异常规则回滚。
关键在于异常是否越过事务方法的调用边界。如果异常在方法内部被捕获,且事务没有被标记为仅回滚,拦截器会请求提交;如果异常传播到拦截器,则由回滚规则决定处理方式。仅回滚(rollback-only)表示事务已经不能提交,即使后续代码正常返回也不能改变这一状态。
因此,只看注解或异常日志不足以判断事务结果。还要确认调用是否经过代理、使用了哪个事务管理器,以及数据库操作是否加入同一事务。
2. 执行主线
先以没有外层事务、需要新建一个 JDBC 本地事务的调用为例。本地事务由一个数据库资源完成提交和回滚;这里的物理事务指数据库连接上真正执行的事务。
- 调用方进入 Spring 代理。代理在业务对象外围执行匹配的增强逻辑。
- 事务拦截器读取注解中的事务属性,并向选定的事务管理器请求事务。
- 事务管理器准备连接和事务状态,随后拦截器继续调用业务方法。
- 方法正常返回时请求提交;方法抛出异常时,先判断回滚规则,匹配则请求回滚,不匹配则仍请求提交。
- 事务完成后,事务管理器清理本次调用负责的资源和上下文。
下面展示新建事务的主要路径,省略开启、提交或回滚自身失败的分支:
图表将在阅读到此处时加载…
各组件的职责如下:
- 事务 Advisor:把事务增强逻辑与适用的方法范围关联起来,让代理知道哪些调用需要事务拦截。
TransactionAttributeSource:读取事务属性,例如传播行为和回滚规则。TransactionInterceptor:围绕业务方法调用执行事务逻辑。PlatformTransactionManager:命令式事务管理接口,提供获取事务、提交和回滚的统一入口。TransactionSynchronizationManager:维护当前线程关联的资源和同步回调。同步回调是在提交前、提交后或事务完成时执行的附加逻辑。
后续默认讨论命令式 JDBC/JPA 事务,也就是通过普通方法调用执行数据库操作的模型。响应式事务使用另一套上下文机制,不能直接套用线程绑定规则。
TransactionInterceptor 的核心不是直接操作 JDBC Connection,而是读取事务属性后委托给选定的事务管理器。不同实现管理的资源不同:
| 事务管理器 | 典型资源 | 主要边界 |
|---|---|---|
DataSourceTransactionManager | 单个 JDBC DataSource | 连接绑定当前线程 |
JdbcTransactionManager | JDBC DataSource | 在 JDBC 事务管理基础上增强异常转换 |
JpaTransactionManager | JPA EntityManager,可协调其 DataSource | Flush、持久化上下文和 JDBC 混用需验证 |
| JTA 实现 | 多个受支持的 XA 资源 | 需要协调器及资源 XA 能力,不覆盖普通 HTTP 调用 |
ReactiveTransactionManager | Reactor Context 中的响应式资源 | 不使用传统线程绑定模型,要求响应式返回类型 |
表中的 DataSource 是 JDBC 连接获取入口,EntityManager 是 JPA 管理实体和持久化操作的接口。Flush 指把持久化上下文中的待处理修改同步到数据库,它不等于提交。XA 是资源参与分布式事务协调的协议能力;普通 HTTP 调用不会自动成为 XA 资源。Reactor Context 是响应式执行链携带上下文的机制,不等同于当前线程上的 ThreadLocal。
2.1 加入已有事务与新建事务
传播行为规定:进入一个事务方法时,如何处理已经存在的事务。因此,getTransaction() 并不等于每次都创建新物理事务。事务管理器会结合传播行为和当前上下文决定:
- 创建新事务;
- 加入已有事务;
- 挂起已有事务后创建新事务;
- 非事务执行;
- 因契约不满足而抛异常。
如果本次调用只是加入已有事务,方法退出时的提交请求不代表共享的物理事务立即提交,资源也不会在每个参与方法结束时都释放。最终提交和清理由负责外层事务边界的调用处理。这些组合规则由12 - 事务传播行为展开。
3. 为什么连接能在多个 DAO 间共享
DAO(数据访问对象)负责执行数据库读写。以常见 JDBC 本地事务为例,事务管理器获得连接后,通过 TransactionSynchronizationManager 把连接资源与当前线程、对应的 DataSource 关联起来。DAO 使用 JdbcTemplate 等 Spring 数据访问工具时,会取得该数据源已绑定的连接,而不是为每次操作另开连接。多个 DAO 因而可以在同一物理事务内执行。
连接共享有前提:操作必须在同一线程中,通过与事务管理器配套的数据源和资源获取方式执行。自行获取不受该事务管理体系协调的连接,不能仅凭外层有 @Transactional 就认定它已加入事务。事务结束后,需要解绑资源、恢复连接状态并释放连接;使用连接池时,释放通常意味着归还池中。
这也是事务默认不会自动跨线程传播的原因:线程绑定数据存放在当前执行线程上下文。把任务提交给线程池后,新线程不会自然继承原事务连接。
ThreadLocal 用于保存每个线程各自的数据,但事务资源不是普通的上下文标识。不能像复制链路追踪标识 TraceId 一样,把 Connection、EntityManager 或 Spring 内部的 ThreadLocal 状态复制给子线程,否则可能让多个线程并发使用非线程安全资源并破坏提交边界。上下文分类见并发 21 - 并发上下文传播与 ScopedValue。
4. 最小示例
下面是服务类片段,省略导入、依赖和应用配置。使用时需要注册该 Spring Bean、启用声明式事务,配置与 JdbcTemplate 使用同一 DataSource 的 JDBC 事务管理器,并准备包含 id、balance 字段的 account 表。调用方应通过容器提供的代理调用 transfer()。以下预期行为假设调用前没有已有事务。
java
@Service
public class TransferService {
private final JdbcTemplate jdbcTemplate;
public TransferService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@Transactional
public void transfer(long from, long to, int amount) {
jdbcTemplate.update(
"update account set balance = balance - ? where id = ?",
amount, from);
jdbcTemplate.update(
"update account set balance = balance + ? where id = ?",
amount, to);
}
}预期行为:两条 UPDATE 使用同一事务连接;方法正常返回后尝试提交。如果第二条语句抛出异常并传播到拦截器,且异常满足回滚规则,则第一条语句的修改也应随事务回滚。这个结论还要求数据库表和操作支持事务。
两条语句在同一事务里,不代表转账业务一定正确。生产实现还需检查余额约束、影响行数、并发更新和隔离级别,并处理幂等性,即重复请求不会重复扣款。示例只展示事务边界。完整数据库模型见数据库 16 - ACID 的工程含义。
5. 提交并不总是立即成功
对于负责新建事务的调用,业务方法正常返回后,事务拦截器才请求提交。数据库约束、连接故障或同步回调仍可能在这一阶段抛异常。因此,方法内部记录“业务方法执行完”时,提交尚未完成。
提交前失败与提交后回调失败也要区分:如果数据库已经提交,之后的回调抛异常并不能撤销这次提交。调用方收到异常,未必意味着数据库修改已经回滚;排障时应定位失败阶段,并核对最终数据状态。
事务同步回调还存在明确阶段,例如提交前、提交后和完成后。afterCommit 适合触发只应在本地事务成功后执行的动作,但如果进程在数据库提交后、外部动作完成前崩溃,事件仍可能丢失。Spring 事务监听的阶段语义见 23 - Spring 事件与事务监听;要求数据库写入与消息最终一致时,应使用 Transactional Outbox 与 CDC,而不是把普通消息发送塞进 afterCommit 后就宣称“不会丢”。
6. 回滚规则
在没有覆盖默认策略的情况下,Spring 声明式事务对传播到拦截器的 RuntimeException 和 Error 回滚,对受检异常(checked exception)不自动回滚。受检异常是 Java 要求调用方捕获或通过 throws 声明的异常。异常是否需要回滚由事务规则决定,不能只从异常名称判断。
需要业务受检异常回滚时,可以使用下面的方法片段;PaymentException 表示项目中定义的业务受检异常,需补齐其定义和实际方法实现:
java
@Transactional(rollbackFor = PaymentException.class)
public void pay() throws PaymentException { }不要无差别使用 rollbackFor = Exception.class 代替异常设计;先明确哪些错误应回滚、哪些是可恢复业务结果。
Spring Framework 6.2 为声明式事务提供了全局默认回滚策略配置能力;较早 6.x 版本没有完全相同的配置入口。若项目依赖全局策略,必须标注精确 Spring 版本,并检查它与方法级 rollbackFor、noRollbackFor 的组合结果。
7. 如何验证事务确实存在
在测试环境中,可以把下面的诊断片段放进业务方法,需导入 org.springframework.transaction.support.TransactionSynchronizationManager:
java
boolean active = TransactionSynchronizationManager.isActualTransactionActive();
String name = TransactionSynchronizationManager.getCurrentTransactionName();active 反映 Spring 是否将当前线程标记为存在实际事务,name 用于观察事务名称。它们不能证明每条 SQL 都使用了该事务连接,也不能证明最终提交或回滚成功。最终验证仍应使用真实数据库结果:
- 在事务方法中完成两次写入;
- 在第二次写入后主动抛出异常;
- 等待被测调用退出,再从另一个连接查询两次写入是否同时回滚,避免用事务结束前的不可见数据误判回滚;
- 再分别验证受检异常、异常被捕获和提交阶段失败。
测试方法自身若带事务,可能在用例结束时统一回滚并掩盖生产行为。验证被测事务边界时,应明确测试框架创建的事务与业务方法创建的事务是否为同一个。
8. 容易踩的坑
- 方法内部捕获异常后正常返回,就期待拦截器按该异常回滚;若事务已被标记为仅回滚,正常返回也不能使其提交。
- 在已持有数据库连接或锁的事务中执行慢远程调用,延长资源占用时间。
- 多数据源选择了错误的事务管理器。
- 事务方法不是通过 Spring 代理调用。
- 用异步任务或线程池并行执行 DAO,并误以为子线程共享当前事务。
- 用
afterCommit代替可靠事件投递协议。 - 把响应式事务当作 ThreadLocal 事务排查。
9. 排障清单
- Bean 是否为事务代理?
- 方法匹配到了什么事务属性?
- 实际使用哪个
PlatformTransactionManager? - 数据访问是否通过同一资源管理体系加入事务?
- 异常是否传播到
TransactionInterceptor? - 最终发生的是提交失败、回滚失败,还是根本没有事务?
- 当前是命令式事务还是响应式事务,资源上下文存放在哪里?
- 测试框架是否额外包裹了事务并改变可见结果?
10. 总结
声明式事务是一段围绕业务方法的代理逻辑:进入前准备资源,退出时根据结果提交或回滚。
@Transactional提供事务元数据,真正执行者是拦截器与事务管理器。- 常见本地事务资源绑定在线程上,默认不能跨线程继承。
- 事务最终结果要看提交或回滚阶段,不能只看业务方法是否返回。
阅读导航
- 代理调用前提:10 - 同类调用为什么绕过 AOP
- 事务边界如何组合:12 - 事务传播行为
- 事务与重试、缓存如何嵌套:24 - Spring 切面顺序与组合语义
- 事务失效证据链:13 - Spring 事务为什么没有回滚
- 数据库事务正确性:数据库 16 - ACID 的工程含义
- 隔离级别与可见性:数据库 17 - 事务隔离级别
- 线程绑定资源边界:并发 21 - 并发上下文传播与 ScopedValue
- 数据库与消息一致性:分布式 29 - Outbox 与 CDC
- 提交阶段事件:23 - Spring 事件与事务监听