Spring事务中@Transactional注解不生效的原因分析与解决

更新时间：2025年03月31日 10:12:53 作者：码农阿豪@新空间

在Spring框架中,@Transactional注解是管理数据库事务的核心方式,本文将深入分析事务自调用的底层原理,解释为什么事务不生效,并提供多种解决方案,希望对大家有所帮助

1. 引言

在Spring框架中，@Transactional注解是管理数据库事务的核心方式。然而，许多开发者在使用时会遇到一个常见问题：在同一个类中，一个方法调用另一个带有@Transactional注解的方法时，事务并未生效。这种现象被称为事务自调用失效。

本文将深入分析事务自调用的底层原理，解释为什么事务不生效，并提供多种解决方案，帮助开发者正确使用Spring事务管理。

2. 事务自调用问题重现

2.1 示例代码

@Service
public class OrderService {

    public void placeOrder(Order order) {
        checkInventory(order);       // 检查库存（非事务）
        deductInventory(order);      // 扣减库存（事务方法）
        createOrder(order);          // 创建订单（非事务）
    }

    @Transactional
    public void deductInventory(Order order) {
        inventoryRepository.reduceStock(order.getProductId(), order.getQuantity());
    }
}

在这个例子中：

placeOrder() 是一个业务方法，调用了 deductInventory()。

deductInventory() 被标记为 @Transactional，期望在扣减库存时开启事务。

2.2 问题现象

当 placeOrder() 调用 deductInventory() 时，事务并未生效。如果 deductInventory() 抛出异常，数据库操作不会回滚。

3. 为什么事务自调用会失效

3.1 Spring事务的代理机制

Spring的事务管理是基于AOP（面向切面编程）实现的，具体来说：

代理模式：Spring会为带有@Transactional的类生成一个代理对象（JDK动态代理或CGLIB代理）。
拦截器：代理对象会在目标方法执行前后添加事务管理逻辑（如开启事务、提交或回滚）。

3.2 自调用绕过代理

public void placeOrder(Order order) {
    this.deductInventory(order);  // 直接调用，不走代理
}

当 placeOrder() 调用 deductInventory() 时，它使用的是 this（即当前对象），而不是Spring生成的代理对象。

因此，事务拦截器没有被触发，事务自然也不会生效。

4. 解决方案

4.1 方法1：拆分到不同类（推荐）

将事务方法移到另一个Service，确保调用通过代理进行：

@Service
public class OrderService {

    @Autowired
    private InventoryService inventoryService;

    public void placeOrder(Order order) {
        checkInventory(order);
        inventoryService.deductInventory(order);  // 通过代理调用
        createOrder(order);
    }
}

@Service
public class InventoryService {

    @Transactional
    public void deductInventory(Order order) {
        inventoryRepository.reduceStock(order.getProductId(), order.getQuantity());
    }
}

优点：

符合单一职责原则（SRP）。
事务管理清晰，不会出现自调用问题。

4.2 方法2：使用 AopContext.currentProxy()

如果必须自调用，可以获取当前代理对象：

@Service
public class OrderService {

    public void placeOrder(Order order) {
        checkInventory(order);
        ((OrderService) AopContext.currentProxy()).deductInventory(order);  // 通过代理调用
        createOrder(order);
    }

    @Transactional
    public void deductInventory(Order order) {
        inventoryRepository.reduceStock(order.getProductId(), order.getQuantity());
    }
}

注意：

需要开启 @EnableAspectJAutoProxy(exposeProxy = true)：

@SpringBootApplication
@EnableAspectJAutoProxy(exposeProxy = true)
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}

缺点：

依赖Spring AOP机制，代码侵入性强。

4.3 方法3：在调用方法上添加 @Transactional

如果整个流程需要事务管理，可以直接在 placeOrder() 上添加 @Transactional：

@Service
public class OrderService {

    @Transactional
    public void placeOrder(Order order) {
        checkInventory(order);
        deductInventory(order);  // 即使自调用，外层事务仍生效
        createOrder(order);
    }

    public void deductInventory(Order order) {
        inventoryRepository.reduceStock(order.getProductId(), order.getQuantity());
    }
}

适用场景：

整个方法需要事务管理，而不是单个操作。

4.4 方法4：使用编程式事务

如果无法拆分类或修改代理设置，可以使用 TransactionTemplate：

@Service
public class OrderService {

    @Autowired
    private TransactionTemplate transactionTemplate;

    public void placeOrder(Order order) {
        checkInventory(order);
        transactionTemplate.execute(status -> {
            deductInventory(order);  // 在事务内执行
            return null;
        });
        createOrder(order);
    }

    public void deductInventory(Order order) {
        inventoryRepository.reduceStock(order.getProductId(), order.getQuantity());
    }
}

优点：

更灵活，可以手动控制事务边界。

5. 最佳实践

避免自调用：尽量将事务方法拆分到不同的类。

合理使用事务：不要在事务方法中执行耗时操作（如HTTP请求、IO操作）。

事务传播机制：理解 @Transactional(propagation = Propagation.REQUIRED) 等选项。

异常处理：确保异常能触发回滚（默认仅回滚 RuntimeException）。

6. 总结

方案	适用场景	优点	缺点
拆分到不同类	推荐方案	符合SRP，事务清晰	需要额外类
AopContext.currentProxy()	必须自调用时	可解决自调用问题	侵入性强
外层方法加 @Transactional	整个流程需要事务	简单直接	事务范围扩大
编程式事务	需要精细控制	灵活	代码冗余

关键结论：

Spring事务基于代理，自调用会绕过代理，导致事务失效。
最佳方案是拆分事务方法到不同类，避免自调用问题。

到此这篇关于Spring事务中@Transactional注解不生效的原因分析与解决的文章就介绍到这了,更多相关Spring @Transactional注解不生效内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

springcloud连接远程nacos失败显示localhost服务连接失败的问题解决
这篇文章主要介绍了springcloud连接远程nacos失败显示localhost服务连接失败的问题解决,文中有详细的代码示例供大家参考,对大家解决问题有一定的帮助,需要的朋友可以参考下
2024-03-03
Spring Security登录接口兼容JSON格式登录实现示例
前后端分离中,前端和后端的数据交互通常是JSON格式,本文主要介绍了Spring Security登录接口兼容JSON格式登录实现示例,具有一定的参考价值,感兴趣的可以了解一下
2024-01-01
SpringBoot实现连接nacos并支持多环境部署
这篇文章主要介绍了SpringBoot实现连接nacos并支持多环境部署方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-06-06
Spring Security 使用 OncePerRequestFilter
OncePerRequestFilter是一个过滤器,每个请求都会执行一次；一般开发中主要是做检查是否已登录、Token是否过期和授权等操作,而每个操作都是一个过滤器,下面介绍Spring Security 使用 OncePerRequestFilter 过滤器校验登录过期、请求日志等操作方法,感兴趣的朋友一起看看吧
2024-06-06
SpringBoot接收前端参数的几种常用方式
在Spring Boot开发中接收参数是非常常见且重要的一部分,依赖于请求的不同场景,Spring Boot提供了多种方式来处理和接收参数,这篇文章主要给大家介绍了关于SpringBoot接收前端参数的几种常用方式,需要的朋友可以参考下
2024-07-07
java编程两种树形菜单结构的转换代码
这篇文章主要介绍了java编程两种树形菜单结构的转换代码，首先介绍了两种树形菜单结构的代码，然后展示了转换器实例代码，最后分享了相关实例及结果演示，具有一定借鉴价值，需要的朋友可以了解下。
2017-12-12
springboot项目启动类错误(找不到或无法加载主类 com.**Application)
本文主要介绍了spring-boot项目启动类错误(找不到或无法加载主类 com.**Application),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-05-05
SpringBoot MCP 入门使用步骤详解
这篇文章主要介绍了SpringBoot MCP 入门使用,本文分步骤给大家介绍的非常详细,需要的朋友可以参考下
2015-09-09
Eclipse下使用ANT编译提示OutOfMemory的解决方法
由于需要使用ANT编译的代码比较多，特别是在第一次变异的时候，会出现OutOfMemory错误。并提示更改ANT_OPTS设定。
2009-04-04
一文详解Java中的反射与new创建对象
Java中的反射（Reflection）和使用new关键字创建对象是两种不同的对象创建方式,各有优缺点和适用场景,本文小编给大家详细介绍了Java中的反射与new创建对象,感兴趣的小伙伴跟着小编一起来看看吧
2024-07-07