在 Spring 中使用 @Transactional 注解遇到嵌套事务时，事务失效问题的常见原因和解决方法大全

原创

猫头虎技术团队 2025-01-08 16:14:14 ©著作权

文章标签 spring java 后端 spring boot spring cloud 文章分类 JavaScript 前端开发

©著作权归作者所有：来自51CTO博客作者猫头虎技术团队的原创作品，请联系作者获取转载授权，否则将追究法律责任

在 Spring 中使用 `@Transactional` 注解遇到嵌套事务时，事务失效问题的常见原因和解决方法大全

大家好，欢迎来到《猫头虎技术团队》的技术分享！今天我们来聊聊 Spring 中使用 @Transactional 注解时的嵌套事务问题。在实际开发中，嵌套事务常常会遇到一些棘手的问题，尤其是当事务失效时，可能会让你抓耳挠腮，头大如斗。不过别担心，猫头虎团队已经整理了常见的原因以及解决方法，带你一步步走出这些坑。

在 Spring 中使用 @Transactional 注解遇到嵌套事务时，事务失效问题的常见原因和解决方法大全_后端

文章目录

在 Spring 中使用 `@Transactional` 注解遇到嵌套事务时，事务失效问题的常见原因和解决方法大全
作者简介

猫头虎是谁？
作者名片 ✍️
加入我们AI共创团队 🌐
加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀

正文

一、什么是嵌套事务？
二、常见的事务失效问题

1. **默认传播行为导致嵌套事务失效**

解决方案：使用 `Propagation.NESTED`

2. **方法内部调用事务方法导致事务失效**

解决方案：分离事务方法到不同的类

3. **回滚策略不正确导致事务失效**

解决方案：使用 `rollbackFor` 和 `noRollbackFor` 属性

4. **事务管理器配置不当**

解决方案：使用支持嵌套事务的事务管理器

5. **数据库不支持保存点机制**

解决方案：使用支持保存点的数据库

三、总结

粉丝福利

🌐 **第一板块：国内可以直接使用的ChatGPT平台**
💳 **第二板块：最稳定的ChatGPT会员充值平台**
联系我与版权声明 📩

作者简介

猫头虎是谁？

大家好，我是猫头虎，猫头虎技术团队创始人，也被大家称为猫哥。我目前是COC北京城市开发者社区主理人、COC西安城市开发者社区主理人，以及云原生开发者社区主理人，在多个技术领域如云原生、前端、后端、运维和AI都具备丰富经验。

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用方法、前沿科技资讯、产品评测、产品使用体验，以及产品优缺点分析、横向对比、技术沙龙参会体验等。我的分享聚焦于云服务产品评测、AI产品对比、开发板性能测试和技术报告。

目前，我活跃在、51CTO、腾讯云、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站、小红书等平台，全网粉丝已超过30万。我所有平台的IP名称统一为猫头虎或猫头虎技术团队。

我希望通过我的分享，帮助大家更好地掌握和使用各种技术产品，提升开发效率与体验。

作者名片 ✍️
博主：猫头虎
全网搜索关键词：猫头虎
作者公众号：猫头虎技术团队
更新日期：2024年10月10日
🌟 欢迎来到猫头虎的博客

正文

一、什么是嵌套事务？

嵌套事务是指在一个事务中，又启动了另一个事务。可以理解为事务中嵌套着事务，它常常出现在需要多个操作组成一组原子性的事务时。Spring 提供了 @Transactional 注解来管理这些事务，并通过事务传播行为（Propagation）来控制事务的传播。

然而，虽然 Spring 提供了强大的事务管理，但在处理嵌套事务时，容易出现一些问题，最常见的就是事务失效问题。

二、常见的事务失效问题

1. 默认传播行为导致嵌套事务失效

Spring 中的 @Transactional 默认传播行为是 Propagation.REQUIRED，这意味着如果当前方法已有事务，它会加入该事务；如果没有事务，则会创建一个新的事务。然而，这样的行为并不意味着真正的嵌套事务。具体来说，Propagation.REQUIRED 会将方法执行纳入外部事务，而不会创建独立的事务。这就导致了一个问题：当嵌套方法发生异常时，外部事务回滚会导致内嵌事务的回滚，但由于没有真正的保存点机制，整个事务可能会被回滚，导致嵌套事务失效。

解决方案：使用 `Propagation.NESTED`

为了避免事务失效问题，我们可以使用 Propagation.NESTED，它会在外部事务中创建一个嵌套事务，并利用数据库的保存点机制。如果嵌套事务失败，可以回滚到保存点，而不会影响外部事务的执行。这个操作是数据库层面支持的，大多数数据库如 MySQL 和 PostgreSQL 都支持事务的保存点。

@Transactional(propagation = Propagation.NESTED)
public void nestedTransactionMethod() {
    // 执行嵌套事务操作
}

2. 方法内部调用事务方法导致事务失效

在 Spring 中，事务是通过 AOP 代理实现的，这意味着事务只会在外部调用方法时生效。如果你在同一个类中调用了另一个使用 @Transactional 注解的方法，Spring 并不会再次创建一个事务，而是直接执行该方法，导致事务失效。

解决方案：分离事务方法到不同的类

为了避免方法内部调用事务方法的问题，可以将事务方法拆分到不同的服务类中，让 Spring 通过 AOP 代理处理事务。这样，Spring 会在外部调用时正确地创建事务。

@Service
public class OuterService {

    @Autowired
    private InnerService innerService;

    @Transactional
    public void outerMethod() {
        innerService.innerMethod(); // 调用嵌套事务方法
    }
}

@Service
public class InnerService {

    @Transactional(propagation = Propagation.NESTED)
    public void innerMethod() {
        // 执行嵌套事务操作
    }
}

3. 回滚策略不正确导致事务失效

默认情况下，Spring 只会在遇到 RuntimeException 或 Error 时进行回滚。而如果你在嵌套事务中抛出了一个受检查的异常（如 SQLException），Spring 默认是不会回滚的。这就可能导致事务没有按预期回滚。

解决方案：使用 `rollbackFor` 和 `noRollbackFor` 属性

你可以通过 @Transactional 注解的 rollbackFor 属性指定哪些异常需要回滚。这样可以确保在嵌套事务中遇到特定异常时进行回滚。

@Transactional(rollbackFor = SQLException.class)
public void transferMoney() {
    // 执行转账操作
}

@Transactional(propagation = Propagation.NESTED, rollbackFor = Exception.class)
public void nestedMethod() {
    // 执行嵌套事务
}

4. 事务管理器配置不当

Spring 中的 DataSourceTransactionManager 默认并不支持嵌套事务。如果你使用的是 JPA 或其他非默认事务管理器，可能会导致嵌套事务无法正确生效。

解决方案：使用支持嵌套事务的事务管理器

如果你在使用 JPA 或其他事务管理方式，确保使用适合的事务管理器。例如，使用 JpaTransactionManager 代替 DataSourceTransactionManager 来支持嵌套事务。

@Bean
public PlatformTransactionManager transactionManager(EntityManagerFactory emf) {
    JpaTransactionManager transactionManager = new JpaTransactionManager();
    transactionManager.setEntityManagerFactory(emf);
    return transactionManager;
}