当前位置: 代码网 > it编程>编程语言>Java > 注解@Transactional原理分析以及常见的坑

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

2025年10月23日 Java 我要评论
这篇文章,会先讲述 @transactional 的 4 种不生效的 case,然后再通过源码解读,分析 @transactional 的执行原理,以及部分 case 不生效的真正原因1项目准备下面是

这篇文章,会先讲述 @transactional 的 4 种不生效的 case,然后再通过源码解读,分析 @transactional 的执行原理,以及部分 case 不生效的真正原因

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 是使用动态代理实现的,如果通过代理直接调用 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 注解默认处理运行时异常,即只有抛出运行时异常时,才会触发事务回滚,否则并不会回滚,至于深层次的原理,源码部分会进行解读。

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

由于子线程的异常不会被外部的线程捕获,所以父线程不抛异常,事务回滚没有生效。

3 源码解读

下面我们从源码的角度,对 @transactional 的执行机制和事务不生效的原因进行解读。

3.1 @transactional 执行机制

我们只看最核心的逻辑,代码中的 interceptororinterceptionadvice 就是 transactioninterceptor 的实例,入参是 this 对象。

红色方框有一段注释,大致翻译为 “它是一个拦截器,所以我们只需调用即可:在构造此对象之前,将静态地计算切入点。”

this 是 reflectivemethodinvocation 对象,成员对象包含 usercontroller 类、testsuccess() 方法、入参和代理对象等。

进入 invoke() 方法后:

前方高能!!!这里就是事务的核心逻辑,包括判断事务是否开启、目标方法执行、事务回滚、事务提交。

3.2 private 导致事务不生效原因

在上面这幅图中,第一个红框区域调用了方法 gettransactionattribute(),主要是为了获取 txattr 变量,它是用于读取 @transactional 的配置,如果这个 txattr = null,后面就不会走事务逻辑,我们看一下这个变量的含义:

我们直接进入 gettransactionattribute(),重点关注获取事务配置的方法。

前方高能!!!这里就是 private 导致事务不生效的原因所在,allowpublicmethodsonly() 一直返回 false,所以重点只关注 ispublic() 方法。

下面通过位与计算,判断是否为 public,对应的几类修饰符如下:

  • public: 1
  • private: 2
  • protected: 4

看到这里,是不是豁然开朗了,有没有觉得很有意思呢~~

3.3 异常不匹配原因

我们继续回到事务的核心逻辑,因为主方法抛出 exception() 异常,进入事务回滚的逻辑:

进入 rollbackon() 方法,判断该异常是否能进行回滚,这个需要判断主方法抛出的 exception() 异常,是否在 @transactional 的配置中:

我们进入 getdepth() 看一下异常规则匹配逻辑,因为我们对 @transactional 配置了 rollbackfor = exception.class,所以能匹配成功:

示例中的 winner 不为 null,所以会跳过下面的环节。但是当 winner = null 时,也就是没有设置 rollbackfor 属性时,会走默认的异常捕获方式。

前方高能!!!这里就是异常不匹配原因的原因所在,我们看一下默认的异常捕获方式:

是不是豁然开朗,当没有设置 rollbackfor 属性时,默认只对 runtimeexception 和 error 的异常执行回滚。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持代码网。

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com