Java 后端 / 系统课时

观察一次事务的执行链路

观察一次事务的执行链路

这篇用日志和数据库状态把一次事务拆成可观察的几个阶段:方法进入、事务开始、SQL 执行、提交或回滚。重点不是记日志文字,而是建立“应用调用发生了什么、数据库最终留下什么”的对应关系。

学习目标

  • 能按时间顺序识别事务开始、SQL 执行、提交和回滚。
  • 能用数据库状态判断一次事务最终是否成功落库。
  • 能结合 Spring 日志和 SQL 日志定位提交前后的异常行为。

一次事务应该观察哪些证据

一次事务至少要同时观察两类证据:应用侧看到的是事务拦截和 SQL 执行顺序,数据库侧看到的是数据最终状态。只看业务方法返回值,无法确认提交是否真的完成;只看数据库结果,也难以定位异常发生在哪个阶段。

一次Spring事务从调用到提交或回滚的执行链路

打开足够的日志证据

在 Spring Boot 中,可以把事务相关日志临时调高,再执行一笔成功事务和一笔失败事务。下面是配置片段,实际应用还需要已有的数据源与事务管理配置。

yaml
logging:
  level:
    org.springframework.transaction: DEBUG
    org.springframework.jdbc.core: DEBUG

预期结果

text
日志级别生效后,可观察到事务拦截与JDBC SQL执行的调试信息;具体日志文案和调用栈会随Spring Boot、事务管理器和数据库驱动版本变化。

日志的价值在于建立顺序。例如先看到事务拦截开始,再看到 SQL 执行,最后看到提交,才能证明这些动作处于同一次执行链路中。不要把某一条 SQL 出现在日志里直接等同于“已经提交”。

用最小事务验证提交

下面使用 Spring JDBC 执行一条更新。假设数据库中已经存在 account 表,并且 id=1 的账户余额为可识别的初始值。这里的 JdbcTemplate、事务管理器和数据库连接由 Spring Boot 按项目配置提供。

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

预期结果

text
方法正常返回,数据库中id=<ID>的账户余额增加<VALUE>;事务完成后查询可以看到已提交的数据。

验证提交时最好在事务方法返回之后重新查询,而不是在同一事务内部用一次查询结果就下结论。真正的验收条件是事务结束后,独立查询仍能看到这次更新。

再验证一次回滚

把业务改成“先更新,再抛出运行时异常”,就能观察异常传播与数据库最终状态之间的关系。默认情况下,Spring 对运行时异常通常执行回滚;具体规则还会受到事务配置影响。

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

预期结果

text
方法抛出IllegalStateException;事务回滚;独立查询时,id=<ID>的账户余额保持事务开始前的值。

这里要特别区分两个瞬间:SQL 成功执行,不等于事务已经成功提交;方法抛出异常,也不等于数据库已经留下了前面的更新。事务的最终状态要以提交或回滚后的数据库结果为准。

根据证据定位异常阶段

排查时可以按固定顺序对照:先确认业务方法是否进入,再确认事务是否开始,然后检查 SQL 是否执行,接着判断异常发生在 SQL 前、SQL 后还是提交阶段,最后用独立查询验证数据库最终状态。

观察证据 能回答的问题
业务方法日志 方法是否真正执行
事务 DEBUG 日志 是否进入事务拦截与事务边界
SQL 日志 哪条 SQL 在事务中执行
提交或回滚相关日志 事务最终如何结束
独立数据库查询 数据最终是否持久化

一个实用原则是:日志负责还原过程,数据库状态负责确认结果。两者能够对上时间和业务动作后,才能准确判断一次事务究竟是在开始、执行、提交还是回滚阶段出了问题。

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

目录与阅读设置

记录一个想法

观察一次事务的执行链路

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

登录哪都通