Java 后端 / 系统课时

配置 rollbackFor 与 noRollbackFor

配置 rollbackFor 与 noRollbackFor

本课解决默认回滚规则与业务语义不一致的问题:让必须失败的 checked exception 触发回滚,也让特定 RuntimeException 在业务允许时提交事务,并明确异常类型匹配与传播边界。

学习目标

  • 使用 rollbackFor 为指定异常增加回滚规则
  • 使用 noRollbackFor 为指定异常声明不回滚规则
  • 判断异常类型匹配和异常传播对最终回滚结果的影响

把默认规则改成业务规则

Spring 默认在事务方法向事务拦截器抛出 RuntimeException 或 Error 时回滚,而普通 checked exception 默认不触发回滚。rollbackFor 用于增加回滚规则,noRollbackFor 用于增加不回滚规则,因此两者都应该表达明确的业务语义。

规则应尽量配置到具体异常类型。过宽的父类会扩大影响范围:例如 rollbackFor = Exception.class 会让大量 checked exception 也进入回滚规则,而 noRollbackFor = RuntimeException.class 则可能放过原本应该回滚的运行时异常。

同时配置回滚与不回滚

以下为片段示例,依赖已经启用的 Spring 事务管理,以及实际实现并注入的 OrderRepository。PaymentRequiredException 是 checked exception,但业务要求它回滚;BusinessWarningException 是 RuntimeException,但这里只代表允许提交的业务告警。

java
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public class OrderService {

    private final OrderRepository orderRepository;

    public OrderService(OrderRepository orderRepository) {
        this.orderRepository = orderRepository;
    }

    @Transactional(
        rollbackFor = PaymentRequiredException.class,
        noRollbackFor = BusinessWarningException.class
    )
    public void createOrder(boolean paymentRequired, boolean warning) throws PaymentRequiredException {
        orderRepository.insertOrder();

        if (paymentRequired) {
            // checked exception 默认不回滚,这里显式要求回滚。
            throw new PaymentRequiredException();
        }

        if (warning) {
            // RuntimeException 默认回滚,这里显式要求不回滚。
            throw new BusinessWarningException();
        }
    }

    public interface OrderRepository {
        void insertOrder();
    }

    public static class PaymentRequiredException extends Exception {
    }

    public static class BusinessWarningException extends RuntimeException {
    }
}

预期结果

text
paymentRequired=true, warning=false:抛出 PaymentRequiredException,事务回滚,订单插入不提交。
paymentRequired=false, warning=true:抛出 BusinessWarningException,但该异常不触发回滚,订单插入可以提交;异常仍继续传播给调用方。
paymentRequired=false, warning=false:方法正常返回,事务正常提交。

noRollbackFor 只改变事务的回滚判定,不会吞掉异常。调用方仍然能够收到 BusinessWarningException;区别只是事务拦截器在没有其他回滚标记时,会按照不回滚规则提交当前事务。

规则匹配看具体异常类型

当一个异常可能匹配多条规则时,Spring 会选择继承层级上匹配更具体的规则。例如父类配置回滚、子类配置不回滚时,实际抛出该子类异常会优先命中更具体的子类规则。

因此配置时应优先使用明确的业务异常,而不是用 Exception 或 RuntimeException 一次覆盖所有情况。规则越具体,后续新增异常类型时越不容易产生意外行为。

异常传播决定规则能否生效

即使配置了 rollbackFor,如果事务方法内部捕获异常后正常返回,事务拦截器通常看不到这次异常,也就不能仅凭回滚规则决定回滚。业务要求失败时,应让异常继续传播;确有必要在方法内部处理异常时,也可以显式把当前事务标记为 rollback-only。

还要注意另一种情况:如果参与同一事务的内部调用已经把事务状态标记为 rollback-only,外层即使捕获异常并继续执行,也不能依靠 noRollbackFor 把这个状态恢复成可提交。

配置时抓住两个边界

遇到必须撤销写入的 checked exception,优先使用 rollbackFor;遇到属于 RuntimeException、但业务明确允许提交的特定异常,再使用 noRollbackFor。两种规则都应限定到具体异常类型,并保证需要触发规则的异常能够传播到事务拦截器边界。

最终策略应同时回答两个问题:什么异常应该回滚,以及事务边界是否能看到这个异常。 只有异常分类和传播边界都正确,配置才会按预期生效。

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

目录与阅读设置

记录一个想法

配置 rollbackFor 与 noRollbackFor

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

登录哪都通