Java 后端 / 系统课时

排查异常被吞导致的不回滚

排查异常被吞导致的不回滚

本课解决“业务已经报错,但数据库仍然提交”的典型事务故障。排查重点不是异常是否发生过,而是异常最终是否穿过事务边界,以及当前事务是否被明确标记为回滚。

学习目标

  • 能沿着异常捕获、事务代理与提交路径定位“不回滚”的原因。
  • 能解释吞掉异常为什么可能让事务按正常返回处理。
  • 能用重新抛出或标记 rollback-only 修复,并验证数据库最终状态。

先确认事务边界看到什么

Spring 事务拦截器通常在调用目标方法前开启或加入事务。方法正常返回时进入提交判断;方法向外抛出符合回滚规则的异常时进入回滚判断。默认情况下,RuntimeException 和 Error 会触发回滚,受检异常需通过 rollbackFor 等规则显式配置。

异常传播与事务提交回滚路径

因此,看到“SQL 执行失败但事务仍提交”时,不要只看数据库错误日志。应先确认异常在哪一层被捕获、捕获后是否继续抛出、事务方法是否确实经过 Spring 代理,以及当前方法是否只是参与了一个更外层的事务。

用一个主示例观察三种处理方式

下面是片段示例,依赖已配置的 Spring JDBC、orders(id, status) 表,并且三个公开方法都由其他 Bean 通过 Spring 代理调用。doBusiness() 先插入订单,再调用 updateInventory() 模拟库存更新失败;每次验证请使用不同的订单 ID。

java
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.transaction.interceptor.TransactionAspectSupport;

@Service
public class OrderService {
    private static final Logger log = LoggerFactory.getLogger(OrderService.class);
    private final JdbcTemplate jdbcTemplate;

    public OrderService(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    @Transactional
    public void swallowException(long orderId) {
        try {
            doBusiness(orderId);
        } catch (RuntimeException ex) {
            // 异常被吞掉,事务边界最终看到的是“方法正常返回”
            log.error("save order failed", ex);
        }
    }

    @Transactional
    public void rethrowException(long orderId) {
        try {
            doBusiness(orderId);
        } catch (RuntimeException ex) {
            log.error("save order failed", ex);
            throw ex;
        }
    }

    @Transactional
    public void markRollbackOnly(long orderId) {
        try {
            doBusiness(orderId);
        } catch (RuntimeException ex) {
            log.error("save order failed", ex);
            // 不继续抛异常,但明确要求当前事务回滚
            TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
        }
    }

    private void doBusiness(long orderId) {
        jdbcTemplate.update(
            "insert into orders(id, status) values (?, ?)",
            orderId,
            "CREATED"
        );
        updateInventory();
    }

    private void updateInventory() {
        throw new IllegalStateException("inventory update failed");
    }
}

预期结果

text
swallowException(<ID>):异常发生在 updateInventory() 内,但 catch 后方法正常返回;若没有其他回滚信号,INSERT 会提交。
rethrowException(<ID>):IllegalStateException 继续抛到事务边界;按默认规则事务回滚,INSERT 不保留。
markRollbackOnly(<ID>):方法可以正常返回,但当前事务被标记为 rollback-only,INSERT 不保留。

这个对比说明,决定事务结果的是事务边界最终收到的信号。仅仅“代码里抛过异常”不足以证明会回滚;异常被 catch 后若没有继续传播,也没有设置回滚标记,事务代理通常会按正常返回继续提交判断。

选择修复方式时注意事务归属

如果异常本身就代表本次业务失败,优先在记录必要上下文后重新抛出,让异常语义和事务语义保持一致。这样调用方也能明确知道操作失败。

如果业务要求“方法不再抛出异常,但数据必须回滚”,可以调用 setRollbackOnly()。当当前方法就是事务拥有者时,事务结束会直接回滚;如果当前方法只是参与外层事务并把共享事务标记为全局回滚,外层代码仍尝试提交时,才可能在外层提交点收到 UnexpectedRollbackException。

用数据库最终数据验证

日志只能证明异常发生过,不能证明事务已经回滚。完成修复后,应直接查询对应订单 ID,确认事务结束后的最终数据;实际 <ID> 替换为本次测试使用的数值。

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

预期结果

text
调用 swallowException(<ID>) 后:返回 1 行,status 为 CREATED。
调用 rethrowException(<ID>) 后:返回 0 行。
调用 markRollbackOnly(<ID>) 后:返回 0 行。

如果查询结果与预期不一致,再继续检查传播行为、外层事务、代理调用方式以及自定义回滚规则。排查这类故障时,最可靠的判断标准始终是:回滚信号是否到达真正拥有事务提交权的边界,以及数据库最终状态是否与该边界的决定一致。

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

目录与阅读设置

记录一个想法

排查异常被吞导致的不回滚

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

登录哪都通