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

程序员蜗牛
71 阅读4分钟

点击上方“程序员蜗牛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;
    }
    // ...
}

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

解决方案

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

图片

二、同一个类中方法调用

问题现象

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

图片

原理分析

图片

解决方案

有几种方法可以解决：

方法1：使用自我注入

图片

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

图片

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

图片

三、异常被吞没

问题现象

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

图片

原理分析

图片

解决方案

有两种解决方法：

方法1：重新抛出异常

图片

方法2：使用TransactionAspectSupport手动回滚

图片

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

问题现象

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

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

图片

原理分析

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

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

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

@Transactional(rollbackFor = RuntimeException.class)

解决方案

有两种解决方法：

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

图片

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

图片

五、数据库不支持事务

问题现象

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

原理分析

图片

解决方案

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

    1. 对于MySQL，使用InnoDB引擎而不是MyISAM
    1. 检查表的创建语句，确保引擎类型正确：
-- 检查表引擎
SHOW TABLE STATUS WHERE Name = 'your_table_name';

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

六、错误的传播行为设置

问题现象

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

图片

原理分析

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("测试");
        // 现在事务会正常回滚
    }
}

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

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

八、事务管理器配置错误

问题现象

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

原理分析

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

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

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

avatar
文章
阅读
粉丝