一口氣說(shuō)出 6種 @Transactional 注解失效場(chǎng)景
引言
昨天公眾號(hào)粉絲咨詢了一個(gè)問題,說(shuō)自己之前面試被問@Transactional注解哪些場(chǎng)景下會(huì)失效,一時(shí)語(yǔ)塞致使面試失敗。所以今天簡(jiǎn)單的和大家分享一下@Transactional相關(guān)的知識(shí)。
@Transactional 注解相信大家并不陌生,平時(shí)開發(fā)中很常用的一個(gè)注解,它能保證方法內(nèi)多個(gè)數(shù)據(jù)庫(kù)操作要么同時(shí)成功、要么同時(shí)失敗。使用@Transactional注解時(shí)需要注意許多的細(xì)節(jié),不然你會(huì)發(fā)現(xiàn)@Transactional總是莫名其妙的就失效了。
一、事務(wù)
事務(wù)管理在系統(tǒng)開發(fā)中是不可缺少的一部分,Spring提供了很好事務(wù)管理機(jī)制,主要分為編程式事務(wù)和聲明式事務(wù)兩種。
編程式事務(wù):是指在代碼中手動(dòng)的管理事務(wù)的提交、回滾等操作,代碼侵入性比較強(qiáng),如下示例:
- try {
- //TODO something
- transactionManager.commit(status);
- } catch (Exception e) {
- transactionManager.rollback(status);
- throw new InvoiceApplyException("異常失敗");
- }
聲明式事務(wù):基于AOP面向切面的,它將具體業(yè)務(wù)與事務(wù)處理部分解耦,代碼侵入性很低,所以在實(shí)際開發(fā)中聲明式事務(wù)用的比較多。聲明式事務(wù)也有兩種實(shí)現(xiàn)方式,一是基于TX和AOP的xml配置文件方式,二種就是基于@Transactional注解了。
- @Transactional
- @GetMapping("/test")
- public String test() {
- int insert = cityInfoDictMapper.insert(cityInfoDict);
- }
二、@Transactional介紹
1、@Transactional注解可以作用于哪些地方?
@Transactional 可以作用在接口、類、類方法。
- 作用于類:當(dāng)把@Transactional 注解放在類上時(shí),表示所有該類的public方法都配置相同的事務(wù)屬性信息。
- 作用于方法:當(dāng)類配置了@Transactional,方法也配置了@Transactional,方法的事務(wù)會(huì)覆蓋類的事務(wù)配置信息。
- 作用于接口:不推薦這種使用方法,因?yàn)橐坏?biāo)注在Interface上并且配置了Spring AOP 使用CGLib動(dòng)態(tài)代理,將會(huì)導(dǎo)致@Transactional注解失效
- @Transactional
- @RestController
- @RequestMapping
- public class MybatisPlusController {
- @Autowired
- private CityInfoDictMapper cityInfoDictMapper;
- @Transactional(rollbackFor = Exception.class)
- @GetMapping("/test")
- public String test() throws Exception {
- CityInfoDict cityInfoDict = new CityInfoDict();
- cityInfoDict.setParentCityId(2);
- cityInfoDict.setCityName("2");
- cityInfoDict.setCityLevel("2");
- cityInfoDict.setCityCode("2");
- int insert = cityInfoDictMapper.insert(cityInfoDict);
- return insert + "";
- }
- }
2、@Transactional注有哪些屬性?
propagation屬性
propagation 代表事務(wù)的傳播行為,默認(rèn)值為 Propagation.REQUIRED,其他的屬性信息如下:
- Propagation.REQUIRED:如果當(dāng)前存在事務(wù),則加入該事務(wù),如果當(dāng)前不存在事務(wù),則創(chuàng)建一個(gè)新的事務(wù)。( 也就是說(shuō)如果A方法和B方法都添加了注解,在默認(rèn)傳播模式下,A方法內(nèi)部調(diào)用B方法,會(huì)把兩個(gè)方法的事務(wù)合并為一個(gè)事務(wù) )
- Propagation.SUPPORTS:如果當(dāng)前存在事務(wù),則加入該事務(wù);如果當(dāng)前不存在事務(wù),則以非事務(wù)的方式繼續(xù)運(yùn)行。
- Propagation.MANDATORY:如果當(dāng)前存在事務(wù),則加入該事務(wù);如果當(dāng)前不存在事務(wù),則拋出異常。
- Propagation.REQUIRES_NEW:重新創(chuàng)建一個(gè)新的事務(wù),如果當(dāng)前存在事務(wù),暫停當(dāng)前的事務(wù)。( 當(dāng)類A中的 a 方法用默認(rèn)Propagation.REQUIRED模式,類B中的 b方法加上采用 Propagation.REQUIRES_NEW模式,然后在 a 方法中調(diào)用 b方法操作數(shù)據(jù)庫(kù),然而 a方法拋出異常后,b方法并沒有進(jìn)行回滾,因?yàn)镻ropagation.REQUIRES_NEW會(huì)暫停 a方法的事務(wù) )
- Propagation.NOT_SUPPORTED:以非事務(wù)的方式運(yùn)行,如果當(dāng)前存在事務(wù),暫停當(dāng)前的事務(wù)。
- Propagation.NEVER:以非事務(wù)的方式運(yùn)行,如果當(dāng)前存在事務(wù),則拋出異常。
- Propagation.NESTED :和 Propagation.REQUIRED 效果一樣。
isolation 屬性
isolation :事務(wù)的隔離級(jí)別,默認(rèn)值為 Isolation.DEFAULT。
- Isolation.DEFAULT:使用底層數(shù)據(jù)庫(kù)默認(rèn)的隔離級(jí)別。
- Isolation.READ_UNCOMMITTED
- Isolation.READ_COMMITTED
- Isolation.REPEATABLE_READ
- Isolation.SERIALIZABLE
timeout 屬性
timeout :事務(wù)的超時(shí)時(shí)間,默認(rèn)值為 -1。如果超過該時(shí)間限制但事務(wù)還沒有完成,則自動(dòng)回滾事務(wù)。
readOnly 屬性
readOnly :指定事務(wù)是否為只讀事務(wù),默認(rèn)值為 false;為了忽略那些不需要事務(wù)的方法,比如讀取數(shù)據(jù),可以設(shè)置 read-only 為 true。
rollbackFor 屬性
rollbackFor :用于指定能夠觸發(fā)事務(wù)回滾的異常類型,可以指定多個(gè)異常類型。
noRollbackFor屬性**
noRollbackFor:拋出指定的異常類型,不回滾事務(wù),也可以指定多個(gè)異常類型。
二、@Transactional失效場(chǎng)景
接下來(lái)我們結(jié)合具體的代碼分析一下哪些場(chǎng)景下,@Transactional 注解會(huì)失效。
1、@Transactional 應(yīng)用在非 public 修飾的方法上
如果Transactional注解應(yīng)用在非public 修飾的方法上,Transactional將會(huì)失效。
在這里插入圖片描述
之所以會(huì)失效是因?yàn)樵赟pring AOP 代理時(shí),如上圖所示 TransactionInterceptor (事務(wù)攔截器)在目標(biāo)方法執(zhí)行前后進(jìn)行攔截,DynamicAdvisedInterceptor(CglibAopProxy 的內(nèi)部類)的 intercept 方法或 JdkDynamicAopProxy 的 invoke 方法會(huì)間接調(diào)用 AbstractFallbackTransactionAttributeSource的 computeTransactionAttribute 方法,獲取Transactional 注解的事務(wù)配置信息。
- protected TransactionAttribute computeTransactionAttribute(Method method,
- Class<?> targetClass) {
- // Don't allow no-public methods as required.
- if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
- return null;
- }
此方法會(huì)檢查目標(biāo)方法的修飾符是否為 public,不是 public則不會(huì)獲取@Transactional 的屬性配置信息。
注意:protected、private 修飾的方法上使用 @Transactional 注解,雖然事務(wù)無(wú)效,但不會(huì)有任何報(bào)錯(cuò),這是我們很容犯錯(cuò)的一點(diǎn)。
2、@Transactional 注解屬性 propagation 設(shè)置錯(cuò)誤
這種失效是由于配置錯(cuò)誤,若是錯(cuò)誤的配置以下三種 propagation,事務(wù)將不會(huì)發(fā)生回滾。
TransactionDefinition.PROPAGATION_SUPPORTS:如果當(dāng)前存在事務(wù),則加入該事務(wù);如果當(dāng)前沒有事務(wù),則以非事務(wù)的方式繼續(xù)運(yùn)行。
TransactionDefinition.PROPAGATION_NOT_SUPPORTED:以非事務(wù)方式運(yùn)行,如果當(dāng)前存在事務(wù),則把當(dāng)前事務(wù)掛起。
TransactionDefinition.PROPAGATION_NEVER:以非事務(wù)方式運(yùn)行,如果當(dāng)前存在事務(wù),則拋出異常。
3、@Transactional 注解屬性 rollbackFor 設(shè)置錯(cuò)誤
rollbackFor 可以指定能夠觸發(fā)事務(wù)回滾的異常類型。Spring默認(rèn)拋出了未檢查unchecked異常(繼承自 RuntimeException的異常)或者 Error才回滾事務(wù);其他異常不會(huì)觸發(fā)回滾事務(wù)。如果在事務(wù)中拋出其他類型的異常,但卻期望 Spring 能夠回滾事務(wù),就需要指定 rollbackFor屬性。
在這里插入圖片描述
- // 希望自定義的異常可以進(jìn)行回滾
- @Transactional(propagation= Propagation.REQUIRED,rollbackFor= MyException.class
若在目標(biāo)方法中拋出的異常是 rollbackFor 指定的異常的子類,事務(wù)同樣會(huì)回滾。Spring源碼如下:
- private int getDepth(Class<?> exceptionClass, int depth) {
- if (exceptionClass.getName().contains(this.exceptionName)) {
- // Found it!
- return depth;
- }
- // If we've gone as far as we can go and haven't found it...
- if (exceptionClass == Throwable.class) {
- return -1;
- }
- return getDepth(exceptionClass.getSuperclass(), depth + 1);
- }
4、同一個(gè)類中方法調(diào)用,導(dǎo)致@Transactional失效
開發(fā)中避免不了會(huì)對(duì)同一個(gè)類里面的方法調(diào)用,比如有一個(gè)類Test,它的一個(gè)方法A,A再調(diào)用本類的方法B(不論方法B是用public還是private修飾),但方法A沒有聲明注解事務(wù),而B方法有。則外部調(diào)用方法A之后,方法B的事務(wù)是不會(huì)起作用的。這也是經(jīng)常犯錯(cuò)誤的一個(gè)地方。
那為啥會(huì)出現(xiàn)這種情況?其實(shí)這還是由于使用Spring AOP代理造成的,因?yàn)橹挥挟?dāng)事務(wù)方法被當(dāng)前類以外的代碼調(diào)用時(shí),才會(huì)由Spring生成的代理對(duì)象來(lái)管理。
- //@Transactional
- @GetMapping("/test")
- private Integer A() throws Exception {
- CityInfoDict cityInfoDict = new CityInfoDict();
- cityInfoDict.setCityName("2");
- /**
- * B 插入字段為 3的數(shù)據(jù)
- */
- this.insertB();
- /**
- * A 插入字段為 2的數(shù)據(jù)
- */
- int insert = cityInfoDictMapper.insert(cityInfoDict);
- return insert;
- }
- @Transactional()
- public Integer insertB() throws Exception {
- CityInfoDict cityInfoDict = new CityInfoDict();
- cityInfoDict.setCityName("3");
- cityInfoDict.setParentCityId(3);
- return cityInfoDictMapper.insert(cityInfoDict);
- }
5、異常被你的 catch“吃了”導(dǎo)致@Transactional失效
這種情況是最常見的一種@Transactional注解失效場(chǎng)景
- @Transactional
- private Integer A() throws Exception {
- int insert = 0;
- try {
- CityInfoDict cityInfoDict = new CityInfoDict();
- cityInfoDict.setCityName("2");
- cityInfoDict.setParentCityId(2);
- /**
- * A 插入字段為 2的數(shù)據(jù)
- */
- insert = cityInfoDictMapper.insert(cityInfoDict);
- /**
- * B 插入字段為 3的數(shù)據(jù)
- */
- b.insertB();
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
如果B方法內(nèi)部拋了異常,而A方法此時(shí)try catch了B方法的異常,那這個(gè)事務(wù)還能正常回滾嗎?
答案:不能!
會(huì)拋出異常:
- org.springframework.transaction.UnexpectedRollbackException: Transaction rolled back because it has been marked as rollback-only
因?yàn)楫?dāng)ServiceB中拋出了一個(gè)異常以后,ServiceB標(biāo)識(shí)當(dāng)前事務(wù)需要rollback。但是ServiceA中由于你手動(dòng)的捕獲這個(gè)異常并進(jìn)行處理,ServiceA認(rèn)為當(dāng)前事務(wù)應(yīng)該正常commit。此時(shí)就出現(xiàn)了前后不一致,也就是因?yàn)檫@樣,拋出了前面的UnexpectedRollbackException異常。
spring的事務(wù)是在調(diào)用業(yè)務(wù)方法之前開始的,業(yè)務(wù)方法執(zhí)行完畢之后才執(zhí)行commit or rollback,事務(wù)是否執(zhí)行取決于是否拋出runtime異常。如果拋出runtime exception 并在你的業(yè)務(wù)方法中沒有catch到的話,事務(wù)會(huì)回滾。
在業(yè)務(wù)方法中一般不需要catch異常,如果非要catch一定要拋出throw new RuntimeException(),或者注解中指定拋異常類型@Transactional(rollbackFor=Exception.class),否則會(huì)導(dǎo)致事務(wù)失效,數(shù)據(jù)commit造成數(shù)據(jù)不一致,所以有些時(shí)候try catch反倒會(huì)畫蛇添足。
6、數(shù)據(jù)庫(kù)引擎不支持事務(wù)
這種情況出現(xiàn)的概率并不高,事務(wù)能否生效數(shù)據(jù)庫(kù)引擎是否支持事務(wù)是關(guān)鍵。常用的MySQL數(shù)據(jù)庫(kù)默認(rèn)使用支持事務(wù)的innodb引擎。一旦數(shù)據(jù)庫(kù)引擎切換成不支持事務(wù)的myisam,那事務(wù)就從根本上失效了。
總結(jié)
@Transactional 注解的看似簡(jiǎn)單易用,但如果對(duì)它的用法一知半解,還是會(huì)踩到很多坑的。