注解@Transactional原理分析以及常見的坑

更新時間：2025年10月23日 10:42:24 作者：吳名氏.

這篇文章主要介紹了注解@Transactional原理分析以及常見的坑,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

1項目準備

下面是 DB 數據和 DB 操作接口：

uid	uname	usex
1	張三	女
2	陳恒	男
3	樓仔	男

// 提供的接口
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);
}

基礎測試代碼，testSuccess() 是事務生效的情況：

@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("事務生效");
    }
}

2事務不生效的幾種 Case

主要講解 4 種事務不生效的 Case：

類內部訪問：A 類的 a1 方法沒有標注 @Transactional，a2 方法標注 @Transactional，在 a1 里面調用 a2；
私有方法：將 @Transactional 注解標注在非 public 方法上；
異常不匹配：@Transactional 未設置 rollbackFor 屬性，方法返回 Exception 等異常；
多線程：主線程和子線程的調用，線程拋出異常。

2.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.testInteralCall();
    } finally {
        MyUser user =  uc.query(1);
        System.out.println("修改后的記錄:" + user);
    }
}
// 輸出：
// 原記錄:MyUser(uid=1, uname=張三, usex=女)
// 修改后的記錄:MyUser(uid=1, uname=張三-testing, usex=女)

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

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

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

2.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，至于深層次的原理，源碼部分會進行解讀。

2.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("事務不生效：異常不匹配");
}

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);
    }
}

// 輸出：
// 原記錄:User[uid=1,uname=張三,usex=女]
// 修改后的記錄:User[uid=1,uname=張三-test,usex=女]

@Transactional 注解默認處理運行時異常，即只有拋出運行時異常時，才會觸發(fā)事務回滾，否則并不會回滾，至于深層次的原理，源碼部分會進行解讀。

2.4 多線程也會導致事務失效

下面給出兩個不同的姿勢，一個是子線程拋異常，主線程 ok；一個是子線程 ok，主線程拋異常。

父線程拋出異常

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

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();
}

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