为什么阿里规范需要在 @Transactional 事务注解中指定 rollbackFor?

本文详细介绍了Java中异常的分类及处理方式,并重点讲解了如何使用@Transactional注解来控制事务回滚策略。包括如何配置使checked exceptions也能触发回滚,以及如何避免事务不回滚的情况。

来源:blog.youkuaiyun.com/Mint6/
article/details/78363761

4b7f1b344c038fa8d2a7ee86d256b2c4.png


java阿里巴巴规范提示:方法【edit】需要在Transactional注解指定rollbackFor或者在方法中显示的rollback。

1.异常的分类

先来看看异常的分类

57e22007b407e3e0ce1edfe780fe3286.png

error是一定会回滚的

这里Exception是异常,他又分为运行时异常RuntimeException和非运行时异常

819dda8c42028cd078d4e946ba632ef1.png
  • 可查的异常(checked exceptions):Exception下除了RuntimeException外的异常

  • 不可查的异常(unchecked exceptions):RuntimeException及其子类和错误(Error)

如果不对运行时异常进行处理,那么出现运行时异常之后,要么是线程中止,要么是主程序终止。如果不想终止,则必须捕获所有的运行时异常,决不让这个处理线程退出。队列里面出现异常数据了,正常的处理应该是把异常数据舍弃,然后记录日志。不应该由于异常数据而影响下面对正常数据的处理。

非运行时异常是RuntimeException以外的异常,类型上都属于Exception类及其子类。如IOException、SQLException等以及用户自定义的Exception异常。对于这种异常,JAVA编译器强制要求我们必需对出现的这些异常进行catch并处理,否则程序就不能编译通过。所以,面对这种异常不管我们是否愿意,只能自己去写一大堆catch块去处理可能的异常。

推荐下自己做的 Spring Boot 的实战项目:

https://github.com/YunaiV/ruoyi-vue-pro

2.@Transactional 的写法

开始主题@Transactional如果只这样写,

Spring框架的事务基础架构代码将默认地只在抛出运行时和unchecked exceptions时才标识事务回滚。也就是说,当抛出个RuntimeException 或其子类例的实例时。(Errors 也一样 - 默认地 - 标识事务回滚。)从事务方法中抛出的Checked exceptions将不被标识进行事务回滚。

  1. 让checked例外也回滚:在整个方法前加上 @Transactional(rollbackFor=Exception.class)

  2. 让unchecked例外不回滚:@Transactional(notRollbackFor=RunTimeException.class)

  3. 不需要事务管理的(只查询的)方法:@Transactional(propagation=Propagation.NOT_SUPPORTED)

注意:如果异常被 try {} catch {} 了,事务就不回滚了,如果想让事务回滚必须再往外抛 try {} catch {throw Exception}

推荐下自己做的 Spring Cloud 的实战项目:

https://github.com/YunaiV/onemall

3. 注意

1、Spring团队的建议是你在具体的类(或类的方法)上使用 @Transactional 注解,而不要使用在类所要实现的任何接口上。

你当然可以在接口上使用 @Transactional 注解,但是这将只能当你设置了基于接口的代理时它才生效。因为注解是不能继承的,这就意味着如果你正在使用基于类的代理时,那么事务的设置将不能被基于类的代理所识别,而且对象也将不会被事务代理所包装(将被确认为严重的)。

因此,请接受Spring团队的建议并且在具体的类上使用 @Transactional 注解。

2、@Transactional 注解标识的方法,处理过程尽量的简单。

尤其是带锁的事务方法,能不放在事务里面的最好不要放在事务里面。

可以将常规的数据库查询操作放在事务前面进行,而事务内进行增、删、改、加锁查询等操作。



文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
<think> 我们正在讨论Spring@Transactional注解的默认回滚行为。根据引用[2]和引用[3]: 引用[2]提到:Spring默认抛出了未检查unchecked异常(继承自RuntimeException的异常)或者Error才回滚事务;其他异常不会触发回滚事务。 引用[3]提到:自定义异常不会默认触发事务回滚。 因此,@Transactional注解默认的rollbackFor异常类型是: - 所有继承自RuntimeException的未检查异常(unchecked exceptions) - 所有继承自Error的严重错误 而受检异常(checked exceptions,即继承自Exception但不属于RuntimeException的异常)默认不会导致事务回滚。 为了验证,我们可以查看Spring官方文档或源码,但根据提供的引用,我们可以总结如下: ### 回答内容: @Transactional注解默认的rollbackFor异常类型为: 1. **未检查异常(unchecked exceptions)**:即`java.lang.RuntimeException`及其子类 2. **错误(Error)**:即`java.lang.Error`及其子类 对于受检异常(checked exceptions,如IOException、SQLException等),默认不会触发事务回滚。如果希望受检异常也能触发回滚,必须通过`rollbackFor`属性显式指定,例如: ```java @Transactional(rollbackFor = IOException.class) public void someMethod() throws IOException { // ... } ``` 另外,如果希望所有异常(包括受检异常)都触发回滚,可以设置为`rollbackFor = Exception.class`: ```java @Transactional(rollbackFor = Exception.class) public void someMethod() { // 任何异常都会导致回滚 } ``` ### 注意事项: - 在事务方法中,通常建议明确指定`rollbackFor`属性,以避免因异常类型不匹配导致的事务不回滚问题[^4]。 - 阿里编程规约中也要求必须在`@Transactional`注解指定`rollbackFor`属性,以增强可读性和避免遗漏[^4][^5]。 ### 相关问题: 根据用户提供的问题,我们生成以下相关问题: §§相关问题§§ 1. 如何让自定义异常触发事务回滚? 2. 在事务方法中抛出受检异常时,事务会回滚吗? 3. 为什么阿里巴巴规范要求必须在@Transactional指定rollbackFor属性? [^1]: 引用[1]: 通过在@Transactional注解中配置rollbackFor参数,可以指定哪些异常会触发事务回滚。 [^2]: 引用[2]: Spring默认抛出了未检查unchecked异常(继承自RuntimeException的异常)或者Error才回滚事务;其他异常不会触发回滚事务。 [^3]: 引用[3]: 自定义异常不会默认触发事务回滚。 [^4]: 引用[4]: 阿里规定需要在事务注解@Transactional指定rollbackFor。 [^5]: 引用[5]: 在事务注解@Transactional指定rollbackFor。 </think> ### @Transactional 默认回滚异常类型 Spring 的 `@Transactional` 注解默认的回滚规则基于异常类型: 1. **默认触发回滚的异常**: - 所有 `RuntimeException` 及其子类(未检查异常) - 所有 `Error` 及其子类(严重错误) ```java // 默认回滚场景示例 @Transactional public void updateData() { // 以下异常会自动触发回滚: throw new NullPointerException(); // RuntimeException子类 throw new OutOfMemoryError(); // Error子类 } ``` 2. **默认不回滚的异常**: - 所有受检异常(`Exception` 的直接子类,除 `RuntimeException` 外) - 自定义异常(未继承 `RuntimeException` 时) ```java @Transactional public void processFile() throws IOException { // 以下异常不会触发自动回滚: throw new IOException(); // 受检异常 throw new CustomBusinessException(); // 自定义非RuntimeException异常 } ``` ### 为什么需要指定 rollbackFor? 根据阿里规范[^4][^5]和 Spring 最佳实践: 1. **避免遗漏**:默认行为只覆盖运行时异常,业务异常常被遗漏 2. **明确契约**:显式声明增强代码可读性 3. **安全回滚**:确保自定义业务异常能正确触发回滚 ### 正确配置示例 ```java // 显式声明回滚规则 @Transactional(rollbackFor = { BusinessException.class, // 自定义异常 IOException.class // 受检异常 }) public void criticalOperation() { // 业务逻辑 } ``` > **关键点**:Spring 默认仅对 `RuntimeException` 和 `Error` 回滚[^2],其他异常需通过 `rollbackFor` 显式声明[^1][^3]。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值