Spring事務@Transactional註解四種不生效案例場景分析

Posted on by

背景

在我們工作中，經常會用到 @Transactional 聲明事務，不正確的使用姿勢會導致註解失效，下面就來分析四種最常見的@Transactional事務不生效的 Case：

類內部訪問：A 類的 a1 方法沒有標註 @Transactional，a2 方法標註 @Transactional，在 a1 裡面調用 a2；

私有方法：將 @Transactional 註解標註在非 public 方法上；

異常不匹配：@Transactional 未設置 rollbackFor 屬性，方法返回 Exception 等異常；

多線程：主線程和子線程的調用，線程拋出異常。

示例代碼

UserDao 接口，操作數據庫；UserController 實現業務邏輯，聲明事務，調用 UserController.testSuccess 方法，事務聲明生效

// 提供的接口
public interface UserDao {
    // select * from user_test where uid = "#{uid}"
    public MyUser selectUserById(Integer uid);
    // update user_test set uname =#{uname},usex = #{usex} where uid = #{uid}
    public int updateUser(MyUser user);
}
@Service
public class UserController {
    @Autowired
    private UserDao userDao;
    public void update(Integer id) {
        MyUser user = new MyUser();
        user.setUid(id);
        user.setUname("張三-testing");
        user.setUsex("女");
        userDao.updateUser(user);
    }
    public MyUser query(Integer id) {
        MyUser user = userDao.selectUserById(id);
        return user;
    }
    // 正常情況
    @Transactional(rollbackFor = Exception.class)
    public void testSuccess() throws Exception {
        Integer id = 1;
        MyUser user = query(id);
        System.out.println("原記錄:" + user);
        update(id);
        throw new Exception("事務生效");
    }
}

 為瞭快速說明問題，直接在controller中實現瞭業務邏輯和事務聲明，不代表生產環境中的代碼分層

1. 類內部訪問

在類 UserController 中新增一個方法 testInteralCall()：

public void testInteralCall() throws Exception {
    testSuccess();
    throw new Exception("事務不生效：類內部訪問");
}

這裡 testInteralCall() 沒有標註 @Transactional，我們再看一下測試用例：

public static void main(String[] args) throws Exception {
    ApplicationContext applicationContext = new ClassPathXmlApplicationContext("applicationContext.xml");
    UserController uc = (UserController) applicationContext.getBean("userController");
    try {
        uc.testSuccess();
    } finally {
        MyUser user =  uc.query(1);
        System.out.println("修改後的記錄:" + user);
    }
}
// 輸出：
// 原記錄:MyUser(uid=1, uname=張三, usex=女)
// 修改後的記錄:MyUser(uid=1, uname=張三-testing, usex=女)

從上面的輸出可以看到，事務並沒有回滾，這個是什麼原因呢？

因為 @Transactional 的工作機制是基於 AOP 實現，AOP 是使用動態代理實現的，如果通過代理直接調用 testSuccess()，通過 AOP 會前後進行增強，增強的邏輯其實就是在 testSuccess() 的前後分別加上開啟、提交事務的邏輯。

現在是通過 testInteralCall() 去調用 testSuccess()，testSuccess() 前後不會進行任何增強操作，也就是類內部調用，不會通過代理方式訪問。

2. 私有方法

在私有方法上，添加 @Transactional 註解也不會生效：

@Transactional(rollbackFor = Exception.class)
private void testPirvateMethod() throws Exception {
    Integer id = 1;
    MyUser user = query(id);
    System.out.println("原記錄:" + user);
    update(id);
    throw new Exception("測試事務生效");
}

直接使用時，下面這種場景不太容易出現，因為 IDEA 會有提醒，文案為: Methods annotated with '@Transactional' must be overridable，至於深層次的原理，源碼部分會給你解讀。

3. 異常不匹配

這裡的 @Transactional 沒有設置 rollbackFor = Exception.class 屬性：

@Transactional
public void testExceptionNotMatch() throws Exception {
    Integer id = 1;
    MyUser user = query(id);
    System.out.println("原記錄:" + user);
    update(id);
    throw new Exception("事務不生效：異常不匹配");
}

@Transactional 註解默認處理運行時異常，即隻有拋出運行時異常時，才會觸發事務回滾，否則並不會回滾，至於深層次的原理，源碼部分會給你解讀。

4. 多線程

父線程拋出異常

父線程拋出異常，子線程不拋出異常：

public void testSuccess() throws Exception {
    Integer id = 1;
    MyUser user = query(id);
    System.out.println("原記錄:" + user);
    update(id);
}
@Transactional(rollbackFor = Exception.class)
public void testMultThread() throws Exception {
    new Thread(new Runnable() {
        @SneakyThrows
        @Override
        public void run() {
            testSuccess();
        }
    }).start();
    throw new Exception("測試事務不生效");
}

父線程拋出線程，事務回滾，因為子線程是獨立存在，和父線程不在同一個事務中，所以子線程的修改並不會被回滾

子線程拋出異常

父線程不拋出異常，子線程拋出異常：

public void testSuccess() throws Exception {
    Integer id = 1;
    MyUser user = query(id);
    System.out.println("原記錄:" + user);
    update(id);
    throw new Exception("測試事務不生效");
}
@Transactional(rollbackFor = Exception.class)
public void testMultThread() throws Exception {
    new Thread(new Runnable() {
        @SneakyThrows
        @Override
        public void run() {
            testSuccess();
        }
    }).start();
}

由於子線程的異常不會被外部的線程捕獲，所以父線程不拋異常，事務回滾沒有生效。

源碼解讀

@Transactional 執行機制

我們隻看最核心的邏輯，代碼中的 interceptorOrInterceptionAdvice 就是 TransactionInterceptor 的實例，入參是 this 對象。

紅色方框有一段註釋，大致翻譯為 “它是一個攔截器，所以我們隻需調用即可：在構造此對象之前，將靜態地計算切入點。”

this 是 ReflectiveMethodInvocation 對象，成員對象包含 UserController 類、testSuccess() 方法、入參和代理對象等。

進入 invoke() 方法後：

前方高能！！！這裡就是事務的核心邏輯，包括判斷事務是否開啟、目標方法執行、事務回滾、事務提交。

private 導致事務不生效原因

在上面這幅圖中，第一個紅框區域調用瞭方法 getTransactionAttribute()，主要是為瞭獲取 txAttr 變量，它是用於讀取 @Transactional 的配置，如果這個 txAttr = null，後面就不會走事務邏輯，我們看一下這個變量的含義：

我們直接進入 getTransactionAttribute()，重點關註獲取事務配置的方法。

前方高能！！！這裡就是 private 導致事務不生效的原因所在，allowPublicMethodsOnly() 一直返回 false，所以重點隻關註 isPublic() 方法。

異常不匹配原因

我們繼續回到事務的核心邏輯，因為主方法拋出 Exception() 異常，進入事務回滾的邏輯：

進入 rollbackOn() 方法，判斷該異常是否能進行回滾，這個需要判斷主方法拋出的 Exception() 異常，是否在 @Transactional 的配置中：

我們進入 getDepth() 看一下異常規則匹配邏輯，因為我們對 @Transactional 配置瞭 rollbackFor = Exception.class，所以能匹配成功：

示例中的 winner 不為 null，所以會跳過下面的環節。但是當 winner = null 時，也就是沒有設置 rollbackFor 屬性時，會走默認的異常捕獲方式。

前方高能！！！這裡就是異常不匹配原因的原因所在，我們看一下默認的異常捕獲方式：

是不是豁然開朗，當沒有設置 rollbackFor 屬性時，默認隻對 RuntimeException 和 Error 的異常執行回滾。

以上就是Spring事務@Transactional註解的四種不生效案例場景分析的詳細內容，更多關於Spring事務@Transactional不生效的資料請關註WalkonNet其它相關文章！

推薦閱讀：