Spring事务失效的8个经典大坑

点击上方“程序员蜗牛g”，选择“设为星标”跟蜗牛哥一起，每天进步一点点程序员蜗牛g大厂程序员一枚 跟蜗牛一起 每天进步一点点31篇原创内容公众号

导致Spring事务失效的8个使用问题。。。

一、事务注解应用在非public方法上

问题现象

开发者在非public方法上添加@Transactional注解，但事务没有生效。

Spring AOP的代理机制默认只拦截public方法。

这是因为事务通知是基于Spring AOP实现的，而Spring AOP默认只拦截public方法调用。

查看AbstractFallbackTransactionAttributeSource类的源码可以发现：

登录后复制

// AbstractFallbackTransactionAttributeSource.java
protected TransactionAttribute computeTransactionAttribute(Method method, Class<?> targetClass) {
    // Don't allow no-public methods as required.
    if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
        return null;
    }
    // ...
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.

非public方法上的@Transactional注解会被直接忽略，返回null，导致事务不生效。

解决方案

确保标注@Transactional的方法为public：

二、同一个类中方法调用

问题现象

在同一个类中，非事务方法调用事务方法，或者事务方法调用另一个具有不同事务属性的方法，事务会失效。

原理分析

解决方案

有几种方法可以解决：

方法1：使用自我注入

方法2：使用AopContext获取代理对象(需要额外配置)

方法3：将方法拆分到不同的类中

三、异常被吞没

问题现象

开发者在事务方法中捕获了异常但没有重新抛出，导致事务无法回滚。

原理分析

解决方案

有两种解决方法：

方法1：重新抛出异常

方法2：使用TransactionAspectSupport手动回滚

四、异常类型不匹配回滚规则

问题现象

开发者抛出了异常，但事务没有回滚。

这通常是因为抛出的异常类型不满足默认的回滚规则。

原理分析

Spring默认只在遇到未检查异常(RuntimeException及其子类)和Error时才回滚事务。

受检异常(如IOException、SQLException)被认为是业务异常，默认情况下不会触发事务回滚。

这是因为@Transactional注解的默认配置是：

登录后复制

@Transactional(rollbackFor = RuntimeException.class)

• 1.

解决方案

有两种解决方法：

方法1：指定回滚的异常类型

方法2：将受检异常转换为非受检异常

五、数据库不支持事务

问题现象

所有事务配置看起来都正确，但事务仍然不生效。

原理分析

解决方案

确保使用支持事务的数据库引擎：

1. 1. 对于MySQL，使用InnoDB引擎而不是MyISAM
2. 2. 检查表的创建语句，确保引擎类型正确：

登录后复制

-- 检查表引擎
SHOW TABLE STATUS WHERE Name = 'your_table_name';

-- 修改表引擎为InnoDB
ALTER TABLE your_table_name ENGINE=InnoDB;

• 1.
• 2.
• 3.
• 4.
• 5.

六、错误的传播行为设置

问题现象

在嵌套事务场景中，内部事务的回滚没有按照预期工作。

原理分析

Spring提供了不同的事务传播行为，用于控制事务的边界。

最常用的是：

使用不当的传播行为会导致事务范围不符合预期，特别是在异常处理场景中。

解决方案

根据业务需求选择正确的传播行为：

传播行为选择指南：

七、未被Spring管理的类

问题现象

在类上添加了@Transactional注解，但事务没有生效。

原理分析

解决方案

确保类被Spring容器管理：

登录后复制

@Service // 正确：添加@Service注解
public class UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    @Transactional
    public void createUser(User user) {
        userMapper.insert(user);
        throw new RuntimeException("测试");
        // 现在事务会正常回滚
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.

同时，确保组件扫描配置正确：

登录后复制

@Configuration
@ComponentScan("com.example.service") // 确保包路径正确
public class AppConfig {
    // ...
}

• 1.
• 2.
• 3.
• 4.
• 5.

八、事务管理器配置错误

问题现象

使用了正确的事务注解，但事务不生效或者出现异常。

原理分析

Spring支持多种事务管理器，针对不同的持久化技术：

如果配置了错误的事务管理器，或者在多数据源环境中未指定正确的事务管理器，会导致事务失效。

解决方案

单数据源环境：确保配置正确的事务管理器

多数据源环境：指定使用的事务管理器

登录后复制

@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) {
        // 使用次数据源的操作
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.
• 36.
• 37.
• 38.
• 39.
• 40.
• 41.

如果这篇文章对您有所帮助，或者有所启发的话，求一键三连：点赞、转发、在看。

关注公众号：woniuxgg，在公众号中回复：笔记  就可以获得蜗牛为你精心准备的java实战语雀笔记，回复面试、开发手册、有超赞的粉丝福利！