Java 后端 / 系统课时
观察一次事务的执行链路
观察一次事务的执行链路
这篇用日志和数据库状态把一次事务拆成可观察的几个阶段:方法进入、事务开始、SQL 执行、提交或回滚。重点不是记日志文字,而是建立“应用调用发生了什么、数据库最终留下什么”的对应关系。
学习目标
- 能按时间顺序识别事务开始、SQL 执行、提交和回滚。
- 能用数据库状态判断一次事务最终是否成功落库。
- 能结合 Spring 日志和 SQL 日志定位提交前后的异常行为。
一次事务应该观察哪些证据
一次事务至少要同时观察两类证据:应用侧看到的是事务拦截和 SQL 执行顺序,数据库侧看到的是数据最终状态。只看业务方法返回值,无法确认提交是否真的完成;只看数据库结果,也难以定位异常发生在哪个阶段。

打开足够的日志证据
在 Spring Boot 中,可以把事务相关日志临时调高,再执行一笔成功事务和一笔失败事务。下面是配置片段,实际应用还需要已有的数据源与事务管理配置。
logging:
level:
org.springframework.transaction: DEBUG
org.springframework.jdbc.core: DEBUG预期结果
日志级别生效后,可观察到事务拦截与JDBC SQL执行的调试信息;具体日志文案和调用栈会随Spring Boot、事务管理器和数据库驱动版本变化。日志的价值在于建立顺序。例如先看到事务拦截开始,再看到 SQL 执行,最后看到提交,才能证明这些动作处于同一次执行链路中。不要把某一条 SQL 出现在日志里直接等同于“已经提交”。
用最小事务验证提交
下面使用 Spring JDBC 执行一条更新。假设数据库中已经存在 account 表,并且 id=1 的账户余额为可识别的初始值。这里的 JdbcTemplate、事务管理器和数据库连接由 Spring Boot 按项目配置提供。
package com.example.demo;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class AccountService {
private final JdbcTemplate jdbcTemplate;
public AccountService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@Transactional
public void addBalance(long accountId, int amount) {
int rows = jdbcTemplate.update(
"update account set balance = balance + ? where id = ?",
amount, accountId
);
if (rows != 1) {
throw new IllegalStateException("account not found");
}
}
}预期结果
方法正常返回,数据库中id=<ID>的账户余额增加<VALUE>;事务完成后查询可以看到已提交的数据。验证提交时最好在事务方法返回之后重新查询,而不是在同一事务内部用一次查询结果就下结论。真正的验收条件是事务结束后,独立查询仍能看到这次更新。
再验证一次回滚
把业务改成“先更新,再抛出运行时异常”,就能观察异常传播与数据库最终状态之间的关系。默认情况下,Spring 对运行时异常通常执行回滚;具体规则还会受到事务配置影响。
@Transactional
public void addBalanceThenFail(long accountId, int amount) {
int rows = jdbcTemplate.update(
"update account set balance = balance + ? where id = ?",
amount, accountId
);
if (rows != 1) {
throw new IllegalStateException("account not found");
}
throw new IllegalStateException("simulate failure");
}预期结果
方法抛出IllegalStateException;事务回滚;独立查询时,id=<ID>的账户余额保持事务开始前的值。这里要特别区分两个瞬间:SQL 成功执行,不等于事务已经成功提交;方法抛出异常,也不等于数据库已经留下了前面的更新。事务的最终状态要以提交或回滚后的数据库结果为准。
根据证据定位异常阶段
排查时可以按固定顺序对照:先确认业务方法是否进入,再确认事务是否开始,然后检查 SQL 是否执行,接着判断异常发生在 SQL 前、SQL 后还是提交阶段,最后用独立查询验证数据库最终状态。
| 观察证据 | 能回答的问题 |
|---|---|
| 业务方法日志 | 方法是否真正执行 |
| 事务 DEBUG 日志 | 是否进入事务拦截与事务边界 |
| SQL 日志 | 哪条 SQL 在事务中执行 |
| 提交或回滚相关日志 | 事务最终如何结束 |
| 独立数据库查询 | 数据最终是否持久化 |
一个实用原则是:日志负责还原过程,数据库状态负责确认结果。两者能够对上时间和业务动作后,才能准确判断一次事务究竟是在开始、执行、提交还是回滚阶段出了问题。