Java 后端 / 系统课时

建立事务问题诊断流程

建立事务问题诊断流程

事务出现没有回滚、部分提交,或异常直到提交阶段才暴露时,不要先反复修改注解。更可靠的做法是沿业务现象、调用路径、事务状态、异常传播和数据库结果逐层取证,把问题收敛到明确的事务边界或数据库行为。

学习目标

  • 建立从业务现象到数据库结果的固定排查顺序
  • 能用运行时事务状态和日志判断事务是否真正生效
  • 区分 Spring 事务边界问题与数据库层问题,减少试错

从现象建立证据链

先记录发生了什么,再讨论原因。重点确认是整笔操作没有提交、只有部分写入成功,还是数据库已经回滚但业务侧误判成功。随后锁定一次完整请求,保留请求 ID、时间点、异常类型以及涉及的数据主键。

排查时沿“业务现象 → 调用入口 → Spring 代理 → 事务边界 → SQL 执行 → commit/rollback → 数据库最终状态”推进,可以把“事务根本没有生效”和“事务已经生效,但结束方式或数据库行为不符合预期”分开。

事务问题从现象到数据库结果的诊断路径

检查事务是否真的进入边界

看到 @Transactional 并不能证明本次调用已经进入事务。首先确认调用是否经过 Spring 代理,再确认方法执行时当前线程是否存在实际事务。下面是片段示例,需要放在由 Spring 管理的 Bean 中,并在待诊断的业务调用链内执行。

java
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);
    }
}

预期输出

text
tx.active=true
tx.readOnly=false

实际结果取决于调用位置和事务配置。active=true 只说明当前线程处于实际事务中,并不代表事务最终一定提交;若为 false,优先检查同类自调用、对象是否由 Spring 容器管理、调用是否绕过代理,以及事务方法是否位于代理可拦截的入口上。

核对异常传播与事务终态

事务是否回滚,不只取决于“代码有没有报错”,还取决于异常是否离开事务边界,以及事务在结束前是否已被标记为 rollback-only。方法内部捕获异常后正常返回时,外层事务可能继续尝试提交;如果内部事务已经把共享事务标记为 rollback-only,提交阶段还可能抛出 UnexpectedRollbackException。

对同一次请求,应把业务异常堆栈、事务日志和 SQL 日志按时间排序。需要确认异常发生在事务边界之内还是之外,异常是否被包装或吞掉,以及最终记录的是 commit 还是 rollback。不要仅凭一条异常日志判断事务结果。

验证数据库最终状态

代码层证据明确后,再查询数据库最终状态。重点比较事务前后的关键记录和受影响对象,看它们是否同时保持旧值或同时进入新状态。若应用侧已确认 rollback,而数据库仍存在本次写入,应继续检查是否使用了不同数据源、独立事务、数据库触发器或事务外写入,而不是继续修改回滚规则。

下面用订单和库存两条关键记录做最小核对,<ID>、<STATUS> 和 <VALUE> 需要替换为本次请求对应的实际值。

sql
SELECT id, status
FROM orders
WHERE id = '<ID>';

SELECT product_id, stock
FROM inventory
WHERE product_id = '<ID>';

预期结果

text
id     status
<ID>   <STATUS>

product_id   stock
<ID>         <VALUE>

实际值可能不同,判断重点不是某个固定状态,而是数据库结果是否与本次事务的预期终态一致。若订单已经变化而库存没有变化,优先回到事务边界、数据源和异常传播路径核对;若两者都没有变化,再检查对应 SQL 是否真正执行。

用固定顺序收敛根因

线上排障可以固定采用“现象 → 调用路径 → 事务状态 → 异常传播 → SQL → 提交或回滚 → 数据库状态”的顺序。每一步都留下请求 ID、日志、运行时状态或查询结果等可验证证据,确认上一层之后再进入下一层。

最终结论应落到可验证的具体根因,例如调用没有经过事务代理、事务边界位置错误、异常被吞掉、事务被标记为 rollback-only,或数据库层存在独立写入,而不是笼统地归结为“@Transactional 失效”。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

建立事务问题诊断流程

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

登录哪都通