【Spring】事务注解失效与传播机制

【Spring】事务注解失效与传播机制

Spring中的事务是通过@Transactional注解来实现的。

一、注解参数

@Transactional 注解的关键属性主要有如下:

重要@Transactional注解的方法不能在同一个类中直接内部调用,否则不走代理会失效。需要通过注入当前类的Bean对象进行调用。

1、isolation(隔离级别)

Isolation 枚举类中定义了五个表示隔离级别的值:

  • Isolation.DEFAULT:使用数据库默认的隔离级别【默认】
  • Isolation.READ_UNCOMMITTED:读取未提交数据(会出现脏读、不可重复读)
  • Isolation.READ_COMMITTED:读取已提交数据(会出现不可重复读和幻读)
  • Isolation.REPEATABLE_READ:可重复读(会出现幻读)
  • Isolation.SERIALIZABLE:串行化

注意:不同数据库的默认隔离级别可能不同(如MySQL默认是REPEATABLE_READ,PostgreSQL默认是READ_COMMITTED)。Spring的Isolation枚举是SQL-92标准的抽象,具体映射由各个数据库驱动实现。

2、propagation(传播行为)

@Transactional(propagation = Propagation.XXX) 主要用于控制方法被其他方法调用时的事务传播机制。

2.1 REQUIRED(默认)

如果当前存在事务,则加入该事务;如果当前没有事务,则创建一个新的事务。

java 复制代码
@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 操作数据库
    methodB(); // 调用另一个事务方法
}
 
@Transactional(propagation = Propagation.REQUIRED)
public void methodB() {
    // 如果methodA有事务,methodB会加入它;否则自己新建事务
}
2.2 REQUIRES_NEW

总是创建一个新的事务,如果当前存在事务,则挂起当前事务。新建的事务完全独立,外层事务失败不会导致内层已提交的事务回滚。

java 复制代码
@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 主事务操作
    try {
        methodB(); // 调用REQUIRES_NEW方法
    } catch (Exception e) {
        // 即使methodB失败,methodA可以继续
    }
}
 
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void methodB() {
    // 强制开启新事务,与methodA的事务独立
}
2.3 NESTED

如果当前存在事务,则在嵌套事务内执行(基于保存点Savepoint)。如果当前没有事务,则与REQUIRED行为相同。

嵌套事务的特点:

  • 内层事务(嵌套事务)失败不影响外层事务
  • 外层事务失败会导致内层嵌套事务一起回滚
  • 需要数据库支持保存点(MySQL的InnoDB不支持真正的嵌套事务)
java 复制代码
@Transactional(propagation = Propagation.REQUIRED)
public void methodA() {
    // 外层事务
    try {
        methodB(); // NESTED传播
    } catch (Exception e) {
        // methodB失败只回滚内层操作
    }
}
 
@Transactional(propagation = Propagation.NESTED)
public void methodB() {
    // 嵌套事务,有自己独立的保存点
}
2.4 SUPPORTS

如果当前存在事务,则加入该事务;如果当前没有事务,则以非事务方式执行。

2.5 MANDATORY

必须在事务中运行,如果当前没有事务,则抛出异常。

2.6 NOT_SUPPORTED

以非事务方式执行操作,如果当前存在事务,则挂起当前事务。挂起事务指暂停当前事务、保存现场、无事务执行、恢复现场的过程。

2.7 NEVER

必须在非事务中运行,如果当前存在事务,则抛出异常。

3、其他参数

3.1 rollbackFor / rollbackForClassName

指定哪些异常发生时需要回滚事务。

3.2 noRollbackFor / noRollbackForClassName

指定哪些异常发生时不需要回滚事务。
重要规则

  1. Spring默认只对RuntimeExceptionError进行事务回滚,Checked Exception默认不回滚
  2. 如果同时配置了rollbackFornoRollbackFor且存在冲突,Spring采用"noRollbackFor优先"的原则
3.3 timeout

事务超时时间(秒),超过该时间事务未完成则自动回滚。

3.4 value / transactionManager

指定使用的事务管理器,用于多数据源场景。

二、事务失效的常见场景

1. 访问权限问题

@Transactional只能应用于public方法,privateprotected、包访问权限的方法上注解无效。

2. 同一个类中的方法直接内部调用

解决方案:通过注入自身代理调用

selfProxy.methodB(); // ✅ 通过代理调用

3. 异常处理不当

  • 自己吞了异常:在方法中捕获异常但没有重新抛出
  • 抛出了错误的异常类型 :抛出的异常不在rollbackFor范围内且不是RuntimeException
java 复制代码
@Transactional
public void saveUser() {
    try {
        userDao.save(user);
    } catch (Exception e) {
        // ❌ 吞掉异常,事务不会回滚
        log.error("保存失败", e);
    }
}

4. 多线程调用

在开启新线程中执行数据库操作,事务不会跨线程传播。

5. 数据库引擎不支持事务

如MySQL使用MyISAM引擎(不支持事务),应使用InnoDB引擎。

三、编程式事务

Spring提供了编程式事务管理,可以更细粒度地控制事务边界:

java 复制代码
@Service
public class UserService {
    
    @Autowired
    private TransactionTemplate transactionTemplate;
    
    public void saveUser(final User user) {
        queryData1();
        queryData2();
        
        try {
            transactionTemplate.execute(status -> {
                addData1();
                updateData2();
                return Boolean.TRUE;
            });
        } catch (Exception e) {
            // 处理异常
            status.setRollbackOnly();
        }
    }
}

编程式事务 vs 声明式事务

  • 声明式事务(@Transactional):简洁,基于AOP,适合大多数场景
  • 编程式事务:更灵活,可以精确控制事务边界,适合复杂业务逻辑

总结要点

  1. 理解事务传播行为的区别,特别是REQUIRED、REQUIRES_NEW、NESTED
  2. 避免事务失效的常见陷阱,特别是自调用问题
  3. 合理配置异常回滚规则,理解冲突处理原则
  4. 根据业务需求选择声明式或编程式事务
相关推荐
Lee川8 小时前
LangChain 加持:后端 AI 流式对话的优雅实现
后端
Javatutouhouduan8 小时前
2026Java面试的正确打开方式!
java·高并发·java面试·java面试题·后端开发·java编程·java八股文
JAVA面经实录9178 小时前
Java初级最终完整版学习路线图
java·spring·eclipse·maven
子兮曰9 小时前
Bun v1.3.14 深度解析:Image API、HTTP/3、全局虚拟存储与五十项变革
前端·后端·bun
Cat_Rocky9 小时前
k8s-持久化存储,粗浅学习
java·学习·kubernetes
ltl9 小时前
Self-Attention:让序列自己看自己
后端
楼兰公子9 小时前
buildroot 在编译rust时裁剪平台类型数量的方法
开发语言·后端·rust
知识领航员10 小时前
蘑兔AI音乐深度实测:功能拆解、实测表现与适用场景
java·c语言·c++·人工智能·python·算法·github
吴声子夜歌10 小时前
Go——并发编程
开发语言·后端·golang
释怀°Believe10 小时前
Spring解析
java·后端·spring