一口氣說出 6種，@Transactional註解的失效場景

阿新 • • 發佈：2020-07-22

引言

昨天公眾號粉絲諮詢了一個問題，說自己之前面試被問@Transactional註解哪些場景下會失效，一時語塞致使面試失敗。所以今天簡單的和大家分享一下@Transactional相關的知識。

@Transactional 註解相信大家並不陌生，平時開發中很常用的一個註解，它能保證方法內多個數據庫操作要麼同時成功、要麼同時失敗。使用@Transactional註解時需要注意許多的細節，不然你會發現@Transactional總是莫名其妙的就失效了。

一、事務

事務管理在系統開發中是不可缺少的一部分，Spring提供了很好事務管理機制，主要分為程式設計式事務和宣告式事務兩種。

程式設計式事務：是指在程式碼中手動的管理事務的提交、回滾等操作，程式碼侵入性比較強，如下示例：

try {
    //TODO something
     transactionManager.commit(status);
} catch (Exception e) {
    transactionManager.rollback(status);
    throw new InvoiceApplyException("異常失敗");
}

宣告式事務：基於AOP面向切面的，它將具體業務與事務處理部分解耦，程式碼侵入性很低，所以在實際開發中宣告式事務用的比較多。宣告式事務也有兩種實現方式，一是基於TX和AOP的xml配置檔案方式，二種就是基於@Transactional註解了。

@Transactional
    @GetMapping("/test")
    public String test() {
    
        int insert = cityInfoDictMapper.insert(cityInfoDict);
    }

二、@Transactional介紹

1、@Transactional註解可以作用於哪些地方？

@Transactional 可以作用在介面、類、類方法。

作用於類：當把@Transactional 註解放在類上時，表示所有該類的public方法都配置相同的事務屬性資訊。
作用於方法：當類配置了@Transactional，方法也配置了@Transactional，方法的事務會覆蓋類的事務配置資訊。

作用於介面：不推薦這種使用方法，因為一旦標註在Interface上並且配置了Spring AOP 使用CGLib動態代理，將會導致@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 代表事務的傳播行為，預設值為 Propagation.REQUIRED，其他的屬性資訊如下：

Propagation.REQUIRED：如果當前存在事務，則加入該事務，如果當前不存在事務，則建立一個新的事務。(也就是說如果A方法和B方法都添加了註解，在預設傳播模式下，A方法內部呼叫B方法，會把兩個方法的事務合併為一個事務）
Propagation.SUPPORTS：如果當前存在事務，則加入該事務；如果當前不存在事務，則以非事務的方式繼續執行。
Propagation.MANDATORY：如果當前存在事務，則加入該事務；如果當前不存在事務，則丟擲異常。
Propagation.REQUIRES_NEW：重新建立一個新的事務，如果當前存在事務，暫停當前的事務。(當類A中的 a 方法用預設Propagation.REQUIRED模式，類B中的 b方法加上採用 Propagation.REQUIRES_NEW模式，然後在 a 方法中呼叫 b方法操作資料庫，然而 a方法丟擲異常後，b方法並沒有進行回滾，因為Propagation.REQUIRES_NEW會暫停 a方法的事務)
Propagation.NOT_SUPPORTED：以非事務的方式執行，如果當前存在事務，暫停當前的事務。
Propagation.NEVER：以非事務的方式執行，如果當前存在事務，則丟擲異常。
Propagation.NESTED ：和 Propagation.REQUIRED 效果一樣。

isolation 屬性

isolation ：事務的隔離級別，預設值為 Isolation.DEFAULT。

Isolation.DEFAULT：使用底層資料庫預設的隔離級別。
Isolation.READ_UNCOMMITTED
Isolation.READ_COMMITTED
Isolation.REPEATABLE_READ
Isolation.SERIALIZABLE

timeout 屬性

timeout ：事務的超時時間，預設值為 -1。如果超過該時間限制但事務還沒有完成，則自動回滾事務。

readOnly 屬性

readOnly ：指定事務是否為只讀事務，預設值為 false；為了忽略那些不需要事務的方法，比如讀取資料，可以設定 read-only 為 true。

rollbackFor 屬性

rollbackFor ：用於指定能夠觸發事務回滾的異常型別，可以指定多個異常型別。

noRollbackFor屬性**

noRollbackFor：丟擲指定的異常型別，不回滾事務，也可以指定多個異常型別。

二、@Transactional失效場景

接下來我們結合具體的程式碼分析一下哪些場景下，@Transactional 註解會失效。

1、@Transactional 應用在非 public 修飾的方法上

如果Transactional註解應用在非public 修飾的方法上，Transactional將會失效。

之所以會失效是因為在Spring AOP 代理時，如上圖所示 TransactionInterceptor （事務攔截器）在目標方法執行前後進行攔截，DynamicAdvisedInterceptor（CglibAopProxy 的內部類）的 intercept 方法或 JdkDynamicAopProxy 的 invoke 方法會間接呼叫
AbstractFallbackTransactionAttributeSource的
computeTransactionAttribute 方法，獲取Transactional 註解的事務配置資訊。

protected TransactionAttribute computeTransactionAttribute(Method method,
    Class<?> targetClass) {
        // Don't allow no-public methods as required.
        if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
        return null;
}

此方法會檢查目標方法的修飾符是否為 public，不是 public則不會獲取@Transactional 的屬性配置資訊。

注意：protected、private 修飾的方法上使用 @Transactional 註解，雖然事務無效，但不會有任何報錯，這是我們很容犯錯的一點。

2、@Transactional 註解屬性 propagation 設定錯誤

這種失效是由於配置錯誤，若是錯誤的配置以下三種 propagation，事務將不會發生回滾。

TransactionDefinition.PROPAGATION_SUPPORTS：如果當前存在事務，則加入該事務；如果當前沒有事務，則以非事務的方式繼續執行。
TransactionDefinition.PROPAGATION_NOT_SUPPORTED：以非事務方式執行，如果當前存在事務，則把當前事務掛起。
TransactionDefinition.PROPAGATION_NEVER：以非事務方式執行，如果當前存在事務，則丟擲異常。

3、@Transactional 註解屬性 rollbackFor 設定錯誤

rollbackFor 可以指定能夠觸發事務回滾的異常型別。Spring預設丟擲了未檢查unchecked異常（繼承自 RuntimeException 的異常）或者 Error才回滾事務；其他異常不會觸發回滾事務。如果在事務中丟擲其他型別的異常，但卻期望 Spring 能夠回滾事務，就需要指定rollbackFor屬性。

// 希望自定義的異常可以進行回滾
@Transactional(propagation= Propagation.REQUIRED,rollbackFor= MyException.class

若在目標方法中丟擲的異常是 rollbackFor 指定的異常的子類，事務同樣會回滾。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、同一個類中方法呼叫，導致@Transactional失效

開發中避免不了會對同一個類裡面的方法呼叫，比如有一個類Test，它的一個方法A，A再呼叫本類的方法B（不論方法B是用public還是private修飾），但方法A沒有宣告註解事務，而B方法有。則外部呼叫方法A之後，方法B的事務是不會起作用的。這也是經常犯錯誤的一個地方。

那為啥會出現這種情況？其實這還是由於使用Spring AOP代理造成的，因為只有當事務方法被當前類以外的程式碼呼叫時，才會由Spring生成的代理物件來管理。

//@Transactional
    @GetMapping("/test")
    private Integer A() throws Exception {
        CityInfoDict cityInfoDict = new CityInfoDict();
        cityInfoDict.setCityName("2");
        /**
         * B 插入欄位為 3的資料
         */
        this.insertB();
        /**
         * A 插入欄位為 2的資料
         */
        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“吃了”導致@Transactional失效

這種情況是最常見的一種@Transactional註解失效場景，

@Transactional
    private Integer A() throws Exception {
        int insert = 0;
        try {
            CityInfoDict cityInfoDict = new CityInfoDict();
            cityInfoDict.setCityName("2");
            cityInfoDict.setParentCityId(2);
            /**
             * A 插入欄位為 2的資料
             */
            insert = cityInfoDictMapper.insert(cityInfoDict);
            /**
             * B 插入欄位為 3的資料
             */
            b.insertB();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

如果B方法內部拋了異常，而A方法此時try catch了B方法的異常，那這個事務還能正常回滾嗎？

答案：不能！

會丟擲異常：

org.springframework.transaction.UnexpectedRollbackException: Transaction rolled back because it has been marked as rollback-only

因為當ServiceB中丟擲了一個異常以後，ServiceB標識當前事務需要rollback。但是ServiceA中由於你手動的捕獲這個異常並進行處理，ServiceA認為當前事務應該正常commit。此時就出現了前後不一致，也就是因為這樣，丟擲了前面的
UnexpectedRollbackException異常。

spring的事務是在呼叫業務方法之前開始的，業務方法執行完畢之後才執行commit or rollback，事務是否執行取決於是否丟擲runtime異常。如果丟擲runtime exception 並在你的業務方法中沒有catch到的話，事務會回滾。

在業務方法中一般不需要catch異常，如果非要catch一定要丟擲throw new RuntimeException()，或者註解中指定拋異常型別@Transactional(rollbackFor=Exception.class)，否則會導致事務失效，資料commit造成資料不一致，所以有些時候try catch反倒會畫蛇添足。

6、資料庫引擎不支援事務

這種情況出現的概率並不高，事務能否生效資料庫引擎是否支援事務是關鍵。常用的MySQL資料庫預設使用支援事務的innodb引擎。一旦資料庫引擎切換成不支援事務的myisam，那事務就從根本上失效了。

總結

@Transactional 註解的看似簡單易用，但如果對它的用法一知半解，還是會踩到很多坑的。

今天就說這麼多，如果本文對您有一點幫助，希望能得到您一個點贊哦

您的認可才是我寫作的動力！

小福利：

幾百本各類技術電子書相送，噓~，免費送給小夥伴們。關注公眾號回覆【電子書】自行領取

作者：程式設計師內點事
連結：
https://juejin.im/post/5e72e97c6fb9a07cb346083f
來源：掘金
著作權歸作者所有。商業轉載請聯絡作者獲得授權，非商業轉載請註明出處。