快捷導(dǎo)航

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

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

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

1項目準(zhǔn)備

下面是 DB 數(shù)據(jù)和 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);
}

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

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

2事務(wù)不生效的幾種 Case

主要講解 4 種事務(wù)不生效的 Case：

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

2.1 類內(nèi)部訪問會導(dǎo)致事務(wù)不生效

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

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

這里 testInteralCall() 沒有標(biāo)注 @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=女)

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

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

現(xiàn)在是通過 testInteralCall() 去調(diào)用 testSuccess()，testSuccess() 前后不會進(jìn)行任何增強(qiáng)操作，也就是類內(nèi)部調(diào)用，不會通過代理方式訪問。

2.2 私有方法也會導(dǎo)致事務(wù)失效

在私有方法上，添加 @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("測試事務(wù)生效");
}

直接使用時，下面這種場景不太容易出現(xiàn)，因為 IDEA 會有提醒，文案為: Methods annotated with '@Transactional' must be overridable，至于深層次的原理，源碼部分會進(jìn)行解讀。

2.3 異常不匹配也會導(dǎo)致事務(wù)失效

這里的 @Transactional 沒有設(shè)置 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("事務(wù)不生效：異常不匹配");
}

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 注解默認(rèn)處理運(yùn)行時異常，即只有拋出運(yùn)行時異常時，才會觸發(fā)事務(wù)回滾，否則并不會回滾，至于深層次的原理，源碼部分會進(jìn)行解讀。

2.4 多線程也會導(dǎo)致事務(wù)失效

下面給出兩個不同的姿勢，一個是子線程拋異常，主線程 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("測試事務(wù)不生效");
}

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

子線程拋出異常

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

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

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