Java 后端 / 系统课时
建立事务问题诊断流程
建立事务问题诊断流程
事务出现没有回滚、部分提交,或异常直到提交阶段才暴露时,不要先反复修改注解。更可靠的做法是沿业务现象、调用路径、事务状态、异常传播和数据库结果逐层取证,把问题收敛到明确的事务边界或数据库行为。
学习目标
- 建立从业务现象到数据库结果的固定排查顺序
- 能用运行时事务状态和日志判断事务是否真正生效
- 区分 Spring 事务边界问题与数据库层问题,减少试错
从现象建立证据链
先记录发生了什么,再讨论原因。重点确认是整笔操作没有提交、只有部分写入成功,还是数据库已经回滚但业务侧误判成功。随后锁定一次完整请求,保留请求 ID、时间点、异常类型以及涉及的数据主键。
排查时沿“业务现象 → 调用入口 → Spring 代理 → 事务边界 → SQL 执行 → commit/rollback → 数据库最终状态”推进,可以把“事务根本没有生效”和“事务已经生效,但结束方式或数据库行为不符合预期”分开。

检查事务是否真的进入边界
看到 @Transactional 并不能证明本次调用已经进入事务。首先确认调用是否经过 Spring 代理,再确认方法执行时当前线程是否存在实际事务。下面是片段示例,需要放在由 Spring 管理的 Bean 中,并在待诊断的业务调用链内执行。
import org.springframework.stereotype.Component;
import org.springframework.transaction.support.TransactionSynchronizationManager;
@Component
public class TransactionProbe {
public void printStatus() {
// 检查当前线程是否处于实际事务,而不是只检查注解是否存在。
boolean active = TransactionSynchronizationManager.isActualTransactionActive();
boolean readOnly = TransactionSynchronizationManager.isCurrentTransactionReadOnly();
System.out.println("tx.active=" + active);
System.out.println("tx.readOnly=" + readOnly);
}
}预期输出
tx.active=true
tx.readOnly=false实际结果取决于调用位置和事务配置。active=true 只说明当前线程处于实际事务中,并不代表事务最终一定提交;若为 false,优先检查同类自调用、对象是否由 Spring 容器管理、调用是否绕过代理,以及事务方法是否位于代理可拦截的入口上。
核对异常传播与事务终态
事务是否回滚,不只取决于“代码有没有报错”,还取决于异常是否离开事务边界,以及事务在结束前是否已被标记为 rollback-only。方法内部捕获异常后正常返回时,外层事务可能继续尝试提交;如果内部事务已经把共享事务标记为 rollback-only,提交阶段还可能抛出 UnexpectedRollbackException。
对同一次请求,应把业务异常堆栈、事务日志和 SQL 日志按时间排序。需要确认异常发生在事务边界之内还是之外,异常是否被包装或吞掉,以及最终记录的是 commit 还是 rollback。不要仅凭一条异常日志判断事务结果。
验证数据库最终状态
代码层证据明确后,再查询数据库最终状态。重点比较事务前后的关键记录和受影响对象,看它们是否同时保持旧值或同时进入新状态。若应用侧已确认 rollback,而数据库仍存在本次写入,应继续检查是否使用了不同数据源、独立事务、数据库触发器或事务外写入,而不是继续修改回滚规则。
下面用订单和库存两条关键记录做最小核对,<ID>、<STATUS> 和 <VALUE> 需要替换为本次请求对应的实际值。
SELECT id, status
FROM orders
WHERE id = '<ID>';
SELECT product_id, stock
FROM inventory
WHERE product_id = '<ID>';预期结果
id status
<ID> <STATUS>
product_id stock
<ID> <VALUE>实际值可能不同,判断重点不是某个固定状态,而是数据库结果是否与本次事务的预期终态一致。若订单已经变化而库存没有变化,优先回到事务边界、数据源和异常传播路径核对;若两者都没有变化,再检查对应 SQL 是否真正执行。
用固定顺序收敛根因
线上排障可以固定采用“现象 → 调用路径 → 事务状态 → 异常传播 → SQL → 提交或回滚 → 数据库状态”的顺序。每一步都留下请求 ID、日志、运行时状态或查询结果等可验证证据,确认上一层之后再进入下一层。
最终结论应落到可验证的具体根因,例如调用没有经过事务代理、事务边界位置错误、异常被吞掉、事务被标记为 rollback-only,或数据库层存在独立写入,而不是笼统地归结为“@Transactional 失效”。