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

本文收錄在 GitHub 地址 https://github.com/chengxy-nds/Springboot-Notebookjavascript

引言

昨天公衆號粉絲諮詢了一個問題,說本身以前面試被問@Transactional註解哪些場景下會失效,一時語塞導致面試失敗。因此今天簡單的和你們分享一下@Transactional相關的知識。java

@Transactional 註解相信你們並不陌生,平時開發中很經常使用的一個註解,它能保證方法內多個數據庫操做要麼同時成功、要麼同時失敗。使用@Transactional註解時須要注意許多的細節,否則你會發現@Transactional老是莫名其妙的就失效了。git

1、事務

事務管理在系統開發中是不可缺乏的一部分,Spring提供了很好事務管理機制,主要分爲編程式事務聲明式事務兩種。github

編程式事務:是指在代碼中手動的管理事務的提交、回滾等操做,代碼侵入性比較強,以下示例:面試

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

聲明式事務:基於AOP面向切面的,它將具體業務與事務處理部分解耦,代碼侵入性很低,因此在實際開發中聲明式事務用的比較多。聲明式事務也有兩種實現方式,一是基於TXAOP的xml配置文件方式,二種就是基於@Transactional註解了。spring

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

2、@Transactional介紹

一、@Transactional註解能夠做用於哪些地方?

@Transactional 能夠做用在接口類方法數據庫

  • 做用於類:當把@Transactional 註解放在類上時,表示全部該類的public方法都配置相同的事務屬性信息。編程

  • 做用於方法:當類配置了@Transactional,方法也配置了@Transactional,方法的事務會覆蓋類的事務配置信息。app

  • 做用於接口:不推薦這種使用方法,由於一旦標註在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 + "";
    }
}

二、@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:拋出指定的異常類型,不回滾事務,也能夠指定多個異常類型。

2、@Transactional失效場景

接下來咱們結合具體的代碼分析一下哪些場景下,@Transactional 註解會失效。

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

若是Transactional註解應用在非public 修飾的方法上,Transactional將會失效。 在這裏插入圖片描述

之因此會失效是由於在Spring AOP 代理時,如上圖所示 TransactionInterceptor (事務攔截器)在目標方法執行先後進行攔截,DynamicAdvisedInterceptor(CglibAopProxy 的內部類)的 intercept 方法或 JdkDynamicAopProxy 的 invoke 方法會間接調用 AbstractFallbackTransactionAttributeSourcecomputeTransactionAttribute 方法,獲取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 的屬性配置信息。

注意:protectedprivate 修飾的方法上使用 @Transactional 註解,雖然事務無效,但不會有任何報錯,這是咱們很容犯錯的一點。

二、@Transactional 註解屬性 propagation 設置錯誤

這種失效是因爲配置錯誤,如果錯誤的配置如下三種 propagation,事務將不會發生回滾。

TransactionDefinition.PROPAGATION_SUPPORTS:若是當前存在事務,則加入該事務;若是當前沒有事務,則以非事務的方式繼續運行。 TransactionDefinition.PROPAGATION_NOT_SUPPORTED:以非事務方式運行,若是當前存在事務,則把當前事務掛起。 TransactionDefinition.PROPAGATION_NEVER:以非事務方式運行,若是當前存在事務,則拋出異常。

三、@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);
}

四、同一個類中方法調用,致使@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);
    }

五、異常被你的 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反倒會多此一舉。

六、數據庫引擎不支持事務

這種狀況出現的機率並不高,事務可否生效數據庫引擎是否支持事務是關鍵。經常使用的MySQL數據庫默認使用支持事務的innodb引擎。一旦數據庫引擎切換成不支持事務的myisam,那事務就從根本上失效了。

總結

@Transactional 註解的看似簡單易用,但若是對它的用法只知其一;不知其二,仍是會踩到不少坑的。

整理了幾百本各種技術電子書,送給小夥伴們。關注公號回覆【666】自行領取。和一些小夥伴們建了一個技術交流羣,一塊兒探討技術、分享技術資料,旨在共同窗習進步,若是感興趣就加入咱們吧!

相關文章
相關標籤/搜索