使用 @Transactional 時常犯的N種錯誤

程式猿DD發表於2021-11-16

@Transactional是我們在用Spring時候幾乎逃不掉的一個註解，該註解主要用來宣告事務。它的實現原理是通過Spring AOP在註解修飾方法的前後織入事務管理的實現語句，所以開發者只需要通過一個註解就能代替一系列繁瑣的事務開始、事務關閉等重複性的編碼任務。

編碼方式確實簡單了，但也因為隱藏了直觀的實現邏輯，一些錯誤的編碼方法可能會讓@Transactional註解失效，達不到事務的作用。最直接的表現就是：方法執行過程中丟擲了異常，但事務沒有回滾，最終導致了髒資料的產生。

之前我在部落格上也寫過一篇有趣的討論我來出個題：這個事務會不會回滾？，當時很多人都給出了標準的錯誤答案，如果沒看過的小夥伴不妨進去挑戰一下？

雖然之前討論了一些特殊情況，但還是一直有小夥伴會郵件、微信群裡問一些關於事務失效的問題。主要還是@Transactional宣告事務失效的情況真的是多種多樣！所以，今天寫一篇總結一下，如果下次再碰到，那就開啟這片文章，一個個順下來看，是不是哪裡寫錯了。當然可能這裡還會有遺漏，所以如果你有其他錯誤案例，也可以告訴我，我會持續整理到這篇文章裡。

1. 在同一個類中呼叫

錯誤案例：

public class A {
    
    public void methodA() {
        methodB();
        
        // 其他操作
    }

    @Transactional
    public void methodB() {
        // 寫資料庫操作
    }
    
}

這類錯誤適用於所有基於Spring AOP實現的註解，比如：《使用@Async實現非同步呼叫》中提到的@Async註解，《使用@Scheduled實現定時任務》中提到的@Scheduled註解，還有Spring快取註解的使用解中提到的@Cacheable註解等。

解決這個問題的方法比較簡單，還是合理規劃好層次關係即可，比如這樣：

@Service
@AllArgsConstructor
public class A {
    
    private B b;
    
    public void methodA() {
        b.methodB();
        // 其他操作
    }
}

@Service
public class B {

    @Transactional
    public void methodB() {
        // 寫資料庫操作
    }
    
}

注意：這裡A類用了構造器注入B的實現（為什麼沒用@Autowrire，可以看看前幾天分享的這篇什麼時候不要用@Autowired注入），建構函式用Lombok的@AllArgsConstructor生成（這個不熟悉的話可以看看之前這篇Lombok：讓JAVA程式碼更優雅）。

2. @Transactional修飾方法不是public

錯誤案例：

public class TransactionalMistake {
    
    @Transactional
    private void method() {
        // 寫資料庫操作
    }
    
}

這也是基於Spring AOP實現的註解所要滿足的要求。這個最簡單，很好理解，也很直觀，就不詳細展開了。直接把方法訪問型別改成public即可。

3. 不同的資料來源

錯誤案例：

public class TransactionalMistake {

    @Transactional
    public void createOrder(Order order) {
        orderRepo1.save(order);
        orderRepo2.save(order);
    }

}

有的時候，我們一個操作可能會同時寫多個資料來源，比如上面這個例子裡的orderRepo1和orderRepo2是連線的兩個不同資料來源。預設情況下，這種跨資料來源的事務是不會成功的。

如果要在多個資料來源之間實現事務，那麼可以引入JTA，具體如何做的話可以看看之前的這篇分享《使用JTA實現多資料來源的事務管理》

4. 回滾異常配置不正確

預設情況下，僅對RuntimeException和Error進行回滾。如果不是的它們及它們的子孫異常的話，就不會回滾。

所以，在自定義異常的時候，要做好適當的規劃，如果要影響事務回滾，可以定義為RuntimeException的子類；如果不是RuntimeException，但也希望觸發回滾，那麼可以使用rollbackFor屬性來指定要回滾的異常。

public class TransactionalMistake {

    @Transactional(rollbackFor = XXXException.class)
    public void method() throws XXXException {

    }

}

5. 資料庫引擎不支援事務

這個來源於一個讀者反饋的例子，程式碼跟我的案例一摸一樣，我這邊是好的，但他就是不回滾。

後來排查出來是因為漏了一個關鍵屬性的配置：

spring.jpa.database-platform=org.hibernate.dialect.MySQL5InnoDBDialect

這裡的spring.jpa.database-platform配置主要用來設定hibernate使用的方言。這裡特地採用了MySQL5InnoDBDialect，主要為了保障在使用Spring Data JPA時候，Hibernate自動建立表的時候使用InnoDB儲存引擎，不然就會以預設儲存引擎MyISAM來建表，而MyISAM儲存引擎是沒有事務的。

如果你的事務沒有生效，那麼可以看看建立的表，是不是使用了MyISAM儲存引擎，如果是的話，那就是這個原因了！

小結

如果你看到最後，發現還有其他情況還沒有囊括其中，歡迎告訴我們喲，我們會持續更新這篇文章！以幫助碰到此類問題的讀者。

好了，今天的學習就到這裡！如果您學習過程中如遇困難？可以加入我們超高質量的Spring技術交流群，參與交流與討論，更好的學習與進步！

歡迎關注我的公眾號：程式猿DD，分享其他地方看不到的知識與思考

相關文章