Spring事务中自定义业务异常需继承RuntimeException才能自动回滚；默认仅对RuntimeException及其子类触发回滚，检查型Exception不会。
在 Spring 事务中，想让自定义业务异常触发回滚，关键不是“抛出”，而是“被 Spring 识别为回滚异常”——默认只对 RuntimeException 及其子类自动回滚，检查型异常（Exception）不会。
确保异常继承 RuntimeException
最直接、推荐的做法：让你的业务异常直接继承 RuntimeException，无需额外配置，Spring 会自动回滚。
例如：
public class InsufficientBalanceException extends RuntimeException {
public InsufficientBalanceException(String message) {
super(message);
}
}
在 service 方法中直接 throw：
立即学习“Java免费学习笔记（深入）”；
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
@Transactional
public void transfer(Long fromId, Long toId, BigDecimal amount) {
if (balanceOf(fromId).compareTo(amount) < 0) {
throw new InsufficientBalanceException("余额不足");
}
// 扣款、入账等操作...
}
用 @Transactional 的 rollbackFor 显式声明
如果因历史原因或规范要求必须使用检查型异常（比如继承 Exception），可通过 @Transactional(rollbackFor = YourException.class) 告诉 Spring 遇到它就回滚。
- 支持类名、Class 对象，也支持多个，如
rollbackFor = {BizException.class, IOException.class} - 注意：不要写成
rollbackFor = Exception.class—— 这会导致所有检查异常都回滚，可能掩盖本该提交的失败场景（如网络超时后重试成功） - 慎用
noRollbackFor，仅用于明确排除某些运行时异常不回滚（极少用）
避免常见陷阱
即使异常类型正确，以下情况仍可能导致回滚失效：
- 异常被吞掉：在方法内 try-catch 了异常但没重新 throw，事务早已结束，回滚无从谈起
-
非代理调用：同一个类中，A 方法调用本类的 B 方法（B 有
@Transactional），B 的事务注解不生效（未走代理），异常抛出也无法触发回滚 -
异步方法：用
@Async的方法默认不在原事务上下文中，需显式传播（如@Async+TransactionSynchronizationManager手动绑定，但通常建议避免在异步中依赖主事务） - 捕获后包装再抛：catch 住原始异常，throw 新的异常时，要确保新异常满足回滚条件（如仍是 RuntimeException 或已配置 rollbackFor）
补充：统一异常处理与事务边界
@RestControllerAdvice 中的 @ExceptionHandler 会捕获异常并返回响应，但它**不阻止事务回滚**——只要异常穿透出事务方法，回滚就已发生。所以可放心全局处理业务异常，返回友好提示，不影响数据一致性。
例如：
@ExceptionHandler(InsufficientBalanceException.class)
public ResponseEntity<String> handleInsufficientBalance(InsufficientBalanceException e) {
return ResponseEntity.badRequest().body("转账失败：" + e.getMessage());
}
此时事务早已回滚，前端收到 400，数据库无脏数据。
