Spring事务失效的8个经典陷阱

Spring事务管理是企业级Java应用的核心功能看似简单的Transactional注解如果使用不当将会引发严重的生产问题比如因事务失效带来的数据不一致问题。事务失效往往不会抛出异常而是静默发生等到业务出现问题时才被发现造成严重的数据不一致。本文将分析8种导致Spring事务失效的使用问题并提供相应的解决方案。一、事务注解应用在非public方法上问题现象开发者在非public方法上添加Transactional注解但事务没有生效。Service public class UserService { Autowired private UserMapper userMapper; // 事务无效方法不是public的 Transactional protected void createUser(User user) { userMapper.insert(user); // 如果这里抛出异常数据不会回滚 } }原理分析Spring AOP的代理机制默认只拦截public方法。这是因为事务通知是基于Spring AOP实现的而Spring AOP默认只拦截public方法调用。查看AbstractFallbackTransactionAttributeSource类的源码可以发现// AbstractFallbackTransactionAttributeSource.java protected TransactionAttribute computeTransactionAttribute(Method method, Class? targetClass) { // Dont allow no-public methods as required. if (allowPublicMethodsOnly() !Modifier.isPublic(method.getModifiers())) { return null; } // ... }非public方法上的Transactional注解会被直接忽略返回null导致事务不生效。解决方案确保标注Transactional的方法为publicService public class UserService { Autowired private UserMapper userMapper; // 正确方法是public的 Transactional public void createUser(User user) { userMapper.insert(user); // 如果抛出异常数据会回滚 } }二、同一个类中方法调用问题现象在同一个类中非事务方法调用事务方法或者事务方法调用另一个具有不同事务属性的方法事务会失效。Service public class OrderService { public void createOrder(Order order) { // 直接调用同类中的事务方法 this.createOrderWithTransaction(order); // 如果createOrderWithTransaction方法抛出异常 // 事务不会回滚 } Transactional public void createOrderWithTransaction(Order order) { // 数据库操作... throw new RuntimeException(故意抛出异常); } }原理分析Spring事务基于动态代理实现当在同一个类中调用方法时是通过this引用调用的而不是通过代理对象。这导致事务切面无法拦截方法调用事务自然就失效了。简言之只有通过代理对象调用方法时Spring事务才会生效。解决方案有几种方法可以解决方法1使用自我注入typescriptService public class OrderService { Autowired private OrderService self; // 自我注入注入的是代理对象 public void createOrder(Order order) { // 通过代理对象调用事务方法 self.createOrderWithTransaction(order); // 如果createOrderWithTransaction方法抛出异常 // 事务会正常回滚 } Transactional public void createOrderWithTransaction(Order order) { // 数据库操作... throw new RuntimeException(故意抛出异常); } }方法2使用AopContext获取代理对象需要额外配置EnableAspectJAutoProxy(exposeProxy true) // 配置类上添加此注解 public class AppConfig { // ... } Service public class OrderService { public void createOrder(Order order) { // 通过AopContext获取代理对象 ((OrderService) AopContext.currentProxy()) .createOrderWithTransaction(order); // 事务会正常工作 } Transactional public void createOrderWithTransaction(Order order) { // 数据库操作... throw new RuntimeException(故意抛出异常); } }方法3将方法拆分到不同的类中Service public class OrderFacadeService { Autowired private TransactionalOrderService orderService; public void createOrder(Order order) { orderService.createOrderWithTransaction(order); // 事务会正常工作 } } Service public class TransactionalOrderService { Transactional public void createOrderWithTransaction(Order order) { // 数据库操作... throw new RuntimeException(故意抛出异常); } }三、异常被吞没问题现象开发者在事务方法中捕获了异常但没有重新抛出导致事务无法回滚。Service public class PaymentService { Autowired private PaymentMapper paymentMapper; Transactional public void processPayment(Payment payment) { try { paymentMapper.insert(payment); // 其他业务逻辑 throw new RuntimeException(支付处理失败); } catch (Exception e) { log.error(支付异常, e); // 错误捕获异常但未重新抛出事务不会回滚 } } }原理分析Spring事务管理器是通过异常触发回滚的。当方法执行过程中抛出异常并且这个异常满足回滚条件时事务管理器才会执行回滚操作。如果异常被捕获且没有重新抛出Spring事务管理器就不知道发生了异常自然不会回滚事务。解决方案有两种解决方法方法1重新抛出异常Service public class PaymentService { Autowired private PaymentMapper paymentMapper; Transactional public void processPayment(Payment payment) { try { paymentMapper.insert(payment); // 其他业务逻辑 throw new RuntimeException(支付处理失败); } catch (Exception e) { log.error(支付异常, e); // 正确重新抛出异常事务会回滚 throw e; // 或者抛出新的异常 } } }方法2使用TransactionAspectSupport手动回滚Service public class PaymentService { Autowired private PaymentMapper paymentMapper; Transactional public void processPayment(Payment payment) { try { paymentMapper.insert(payment); // 其他业务逻辑 throw new RuntimeException(支付处理失败); } catch (Exception e) { log.error(支付异常, e); // 正确手动标记事务回滚 TransactionAspectSupport.currentTransactionStatus().setRollbackOnly(); } } }四、异常类型不匹配回滚规则问题现象开发者抛出了异常但事务没有回滚。这通常是因为抛出的异常类型不满足默认的回滚规则。Service public class ReportService { Autowired private ReportMapper reportMapper; Transactional public void generateReport() { reportMapper.insertReportData(); // 其他业务逻辑 if (somethingWrong()) { // 抛出受检异常默认不会导致事务回滚 throw new IOException(报告生成失败); } } }原理分析Spring默认只在遇到未检查异常RuntimeException及其子类和Error时才回滚事务。受检异常如IOException、SQLException被认为是业务异常默认情况下不会触发事务回滚。这是因为Transactional注解的默认配置是Transactional(rollbackFor RuntimeException.class)解决方案有两种解决方法方法1指定回滚的异常类型Service public class ReportService { Autowired private ReportMapper reportMapper; // 正确指定回滚的异常类型包括IOException Transactional(rollbackFor {IOException.class}) public void generateReport() throws IOException { reportMapper.insertReportData(); // 其他业务逻辑 if (somethingWrong()) { throw new IOException(报告生成失败); // 现在会触发事务回滚 } } }方法2将受检异常转换为非受检异常Service public class ReportService { Autowired private ReportMapper reportMapper; Transactional public void generateReport() { reportMapper.insertReportData(); // 其他业务逻辑 try { if (somethingWrong()) { throw new IOException(报告生成失败); } } catch (IOException e) { // 将受检异常转换为非受检异常 throw new RuntimeException(报告生成失败, e); // 现在会触发事务回滚 } } }五、数据库不支持事务问题现象所有事务配置看起来都正确但事务仍然不生效。原理分析某些数据库引擎不支持事务功能。最常见的例子是MySQL的MyISAM引擎它不支持事务操作。如果表使用的是MyISAM引擎即使Spring事务配置正确也无法实现事务回滚。解决方案确保使用支持事务的数据库引擎对于MySQL使用InnoDB引擎而不是MyISAM检查表的创建语句确保引擎类型正确-- 检查表引擎 SHOW TABLE STATUS WHERE Name your_table_name; -- 修改表引擎为InnoDB ALTER TABLE your_table_name ENGINEInnoDB;六、错误的传播行为设置问题现象在嵌套事务场景中内部事务的回滚没有按照预期工作。Service public class OrderService { Autowired private PaymentService paymentService; Transactional public void createOrder(Order order) { // 保存订单 orderMapper.insert(order); try { // 调用支付服务 paymentService.processPayment(order.getPayment()); } catch (Exception e) { log.error(支付失败但订单已创建, e); // 处理支付失败逻辑但期望订单依然保存 } } } Service public class PaymentService { // 错误的传播行为会影响外部事务 Transactional(propagation Propagation.REQUIRED) public void processPayment(Payment payment) { paymentMapper.insert(payment); throw new RuntimeException(支付处理失败); } }原理分析Spring提供了不同的事务传播行为用于控制事务的边界。最常用的是REQUIRED默认值如果当前存在事务则加入该事务如果不存在则创建新事务REQUIRES_NEW创建新事务如果当前存在事务则挂起当前事务NESTED如果当前存在事务则创建嵌套事务如果不存在则等同于REQUIREDSUPPORTS如果当前存在事务则加入该事务如果不存在则以非事务方式执行使用不当的传播行为会导致事务范围不符合预期特别是在异常处理场景中。解决方案根据业务需求选择正确的传播行为Service public class OrderService { Autowired private PaymentService paymentService; Transactional public void createOrder(Order order) { // 保存订单 orderMapper.insert(order); try { // 调用支付服务 paymentService.processPayment(order.getPayment()); } catch (Exception e) { log.error(支付失败但订单已创建, e); // 处理支付失败逻辑但期望订单依然保存 } } } Service public class PaymentService { // 正确使用REQUIRES_NEW创建独立事务 Transactional(propagation Propagation.REQUIRES_NEW) public void processPayment(Payment payment) { paymentMapper.insert(payment); throw new RuntimeException(支付处理失败); // 只有支付事务会回滚不影响外部订单事务 } }传播行为选择指南如果希望内部方法的异常不影响外部事务使用REQUIRES_NEW如果希望内部方法的回滚不影响外部事务但共享同一连接使用NESTED注意这需要数据库支持保存点如果希望完全共享外部事务的命运使用REQUIRED七、未被Spring管理的类问题现象在类上添加了Transactional注解但事务没有生效。// 未被Spring容器管理 public class UserService { Autowired private UserMapper userMapper; Transactional public void createUser(User user) { userMapper.insert(user); throw new RuntimeException(测试); // 事务不会回滚 } }原理分析Spring事务是通过AOP实现的只有被Spring容器管理的Bean才能被代理进而应用事务切面。如果类没有被Spring正确识别为BeanTransactional注解就无法生效。常见的原因包括类上缺少Component、Service等注解类没有被组件扫描到类是通过new关键字直接创建的实例解决方案确保类被Spring容器管理Service // 正确添加Service注解 public class UserService { Autowired private UserMapper userMapper; Transactional public void createUser(User user) { userMapper.insert(user); throw new RuntimeException(测试); // 现在事务会正常回滚 } }同时确保组件扫描配置正确Configuration ComponentScan(com.example.service) // 确保包路径正确 public class AppConfig { // ... }体验AI代码助手八、事务管理器配置错误问题现象使用了正确的事务注解但事务不生效或者出现异常。原理分析Spring支持多种事务管理器针对不同的持久化技术DataSourceTransactionManager适用于JDBC和MyBatisJpaTransactionManager适用于JPAHibernateTransactionManager适用于Hibernate如果配置了错误的事务管理器或者在多数据源环境中未指定正确的事务管理器会导致事务失效。解决方案单数据源环境确保配置正确的事务管理器Configuration EnableTransactionManagement public class DatabaseConfig { Bean public DataSource dataSource() { // 数据源配置... return new HikariDataSource(); } Bean public PlatformTransactionManager transactionManager(DataSource dataSource) { // 使用与持久化技术匹配的事务管理器 return new DataSourceTransactionManager(dataSource); } }多数据源环境指定使用的事务管理器Configuration EnableTransactionManagement public class MultiDatabaseConfig { Bean public DataSource primaryDataSource() { // 主数据源配置... return new HikariDataSource(); } Bean public DataSource secondaryDataSource() { // 次数据源配置... return new HikariDataSource(); } Bean public PlatformTransactionManager primaryTransactionManager() { return new DataSourceTransactionManager(primaryDataSource()); } Bean public PlatformTransactionManager secondaryTransactionManager() { return new DataSourceTransactionManager(secondaryDataSource()); } } Service public class UserService { // 指定使用的事务管理器 Transactional(transactionManager primaryTransactionManager) public void createUser(User user) { // 使用主数据源的操作 } Transactional(transactionManager secondaryTransactionManager) public void createUserLog(UserLog log) { // 使用次数据源的操作 } }总结Spring事务是一个强大的特性但也隐藏着许多陷阱。理解这些陷阱的原理可以帮助你更好地利用Spring事务构建更加健壮的应用程序。原文链接https://juejin.cn/post/7507820125946511414