@Transactional的失效场景和使用注意

@Transactional的失效场景和使用注意 一、@Transactional简单介绍

事务管理是应用系统开发中必不可少的一部分。Spring 事务管理分为编码式和声明式的两种方式。声明式事务有两种方式，一种是在配置文件（xml）中做相关的事务规则声明，另一种是基于@Transactional 注解的方式。 本文介绍的是基于 @Transactional 注解的事务管理。

1、@Transactional注解可以作用于哪些地方？

@Transactional 可以作用在接口、类、类方法

• 作用于类：当把@Transactional 注解放在类上时，表示所有该类的public方法都配置相同的事务属性信息。
• 作用于方法：当类配置了@Transactional，方法也配置了@Transactional，方法的事务会覆盖类的事务配置信息。
• 作用于接口：不推荐这种使用方法，因为一旦标注在Interface上并且配置了Spring AOP 使用CGLib动态代理，将会导致@Transactional注解失效

2、@Transactional注有哪些属性？

下表为 @Transactional 注解的属性信息

属性名

说明

name

当在配置文件中有多个 TransactionManager , 可以用该属性指定选择哪个事务管理器。

propagation

事务的传播行为，默认值为 REQUIRED。Propagation.REQUIRED：如果当前存在事务，则加入该事务，如果当前不存在事务，则创建一个新的事务。Propagation.SUPPORTS：如果当前存在事务，则加入该事务；如果当前不存在事务，则以非事务的方式继续运行。 Propagation.MANDATORY：如果当前存在事务，则加入该事务；如果当前不存在事务，则抛出异常。 Propagation.REQUIRES_NEW：重新创建一个新的事务，如果当前存在事务，暂停当前的事务。Propagation.NOT_SUPPORTED：以非事务的方式运行，如果当前存在事务，暂停当前的事务。 Propagation.NEVER：以非事务的方式运行，如果当前存在事务，则抛出异常。 Propagation.NESTED ：和 Propagation.REQUIRED 效果一样。

isolation

事务的隔离度，默认值采用 DEFAULT。

timeout

事务的超时时间，默认值为-1。如果超过该时间限制但事务还没有完成，则自动回滚事务。

read-only

指定事务是否为只读事务，默认值为 false；为了忽略那些不需要事务的方法，比如读取数据，可以设置 read-only 为 true。

rollback-for

用于指定能够触发事务回滚的异常类型，如果有多个异常类型需要指定，各类型之间可以通过逗号分隔。

no-rollback- for

抛出 no-rollback-for 指定的异常类型，不回滚事务。

二、@Transactional失效场景 1、@Transactional 应用在非 public 修饰的方法上

Spring 默认通过动态代理的方式实现 AOP，对目标方法进行增强，protected/private 方法无法代理到，Spring 自然也无法动态增强事务处理逻辑。

注意：protected、private修饰的方法上使用 @Transactional 注解，虽然事务无效，但不会有任何报错，这是我们很容犯错的一点。

由上得出 @Transactional 生效原则 1： 除非特殊配置（比如使用 AspectJ 静态织入实现 AOP），否则只有定义在 public 方法上的 @Transactional 才能生效。

2、同一个类中方法调用，导致@Transactional失效

开发中避免不了会对同一个类里面的方法调用，比如有一个类Test，它的一个方法A，A再调用本类的方法B（不论方法B是用public还是private修饰），但方法A没有声明注解事务，而B方法有。则外部调用方法A之后，方法B的事务是不会起作用的。这也是经常犯错误的一个地方。

由上得出 @Transactional 生效原则 2 ：必须通过代理过的类从外部调用目标方法才能生效。

3、@Transactional 注解属性 propagation 设置错误

这种失效是由于配置错误，若是错误的配置以下三种 propagation，事务将不会发生回滚。

• TransactionDefinition.PROPAGATION_SUPPORTS：如果当前存在事务，则加入该事务；如果当前没有事务，则以非事务的方式继续运行。
• TransactionDefinition.PROPAGATION_NOT_SUPPORTED：以非事务方式运行，如果当前存在事务，则把当前事务挂起。
• TransactionDefinition.PROPAGATION_NEVER：以非事务方式运行，如果当前存在事务，则抛出异常。

4、数据库引擎不支持事务

这种情况出现的概率并不高，事务能否生效的关键在于数据库引擎是否支持事务。

常用的MySQL数据库默认使用支持事务的innodb引擎。一旦数据库引擎切换成不支持事务的myisam，那事务就从根本上失效了。

三、@Transactional生效不回滚的场景

@Transactional 底层原理是通过 AOP 实现事务处理的： 具体可以理解为，使用 try…catch…来包裹标记了 @Transactional 注解的方法，当方法出现了异常并且满足 一定条件 的时候，在 catch 里面我们可以设置事务回滚，没有异常则直接提交事务。

这里的“一定条件”，主要包括两点。

第一，只有异常传播出了标记了 @Transactional 注解的方法，事务才能回滚。 第二，默认情况下，出现 RuntimeException（非受检异常）或 Error 的时候，Spring 才会回滚事务。

由上述描述可知：有两种情况事务是不回滚的。

• 异常无法传播出方法，导致事务无法回滚
• 即使出了受检异常也无法让事务回滚

对应的解决方法有：

• 1.如果你希望自己捕获异常进行处理的话，也没关系，可以手动设置让当前事务处于回滚状态：TransactionAspectSupport.currentTransactionStatus().setRollbackonly();
• 2.如果希望 Spring 针对其他异常也可以回滚，那么可以相应配置 @Transactional 注解的 rollbackFor 和 noRollbackFor 属性来覆盖其默认设置。 例如：期望遇到所有的 Exception 都回滚事务（来突破默认不回滚 受检异常的限制）：@Transactional(rollbackFor = Exception.class)

四、@Transactional使用防坑小结

@Transactional使用上可能遇到的三类坑，包括：

• 第一，因为配置不正确，导致方法上的事务没生效。

我们务必确认调用 @Transactional 注解标记的方法是 public 的，并且是通过 Spring 注入的 Bean 进行调用的。

• 第二，因为异常处理不正确，导致事务虽然生效但出现异常时没回滚。

Spring 默认只会对标记 @Transactional 注解的方法出现了 RuntimeException 和 Error 的时候回滚，如果我们的方法捕获了异常，那么需要通过手动编码处理事务回滚。

如果希望 Spring 针对其他异常也可以回滚，那么可以相应配置 @Transactional 注解的 rollbackFor 和 noRollbackFor 属性来覆盖其默认设置。

• 第三，如果方法涉及多次数据库 *** 作，并希望将它们作为独立的事务进行提交或回滚。

那么我们需要考虑进一步细化配置 事务传播方式，也就是 @Transactional 注解的 Propagation 属性。