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,但这里只代表允许提交的业务告警。
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 {
}
}预期结果
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。两种规则都应限定到具体异常类型,并保证需要触发规则的异常能够传播到事务拦截器边界。
最终策略应同时回答两个问题:什么异常应该回滚,以及事务边界是否能看到这个异常。 只有异常分类和传播边界都正确,配置才会按预期生效。