SpringBoot事务失效问题原因、场景与解决方案_Java

一、事务失效的常见场景

1.1 同类中方法直接调用导致事务失效

原因分析：

spring 的事务是通过 aop 代理实现的，只有通过代理对象调用的方法，事务才会生效。如果在同一个类中，一个方法直接调用另一个带有 @transactional 注解的方法（即 this.method() 方式），则事务不会生效。

示例代码：

@service
public class userservice {

    @transactional
    public void createuser(user user) {
        // 保存用户
    }

    public void createuserandlog(user user) {
        this.createuser(user); // 事务失效
        log.info("用户创建成功");
    }
}

解决方案：

将事务方法提取到另一个类中，通过 spring 注入调用。
使用 aopcontext.currentproxy() 获取当前代理对象调用方法。
自我注入：将当前 service 注入到自身，通过注入的对象调用方法。

推荐方式（自我注入）：

@service
public class userservice {

    @autowired
    private userservice self; // 自我注入

    @transactional
    public void createuser(user user) {
        // 保存用户
    }

    public void createuserandlog(user user) {
        self.createuser(user); // 事务生效
        log.info("用户创建成功");
    }
}

1.2 异常未被正确捕获或抛出

原因分析：

默认情况下，spring 只对 runtimeexception 和 error 进行回滚。如果捕获了异常但未抛出，或抛出了非运行时异常，事务不会回滚。

示例代码：

@transactional
public void updateuser(user user) {
    try {
        userrepository.save(user);
    } catch (exception e) {
        log.error("更新失败", e);
        // 异常被吞掉，事务不会回滚
    }
}

解决方案：

在 @transactional 注解中指定回滚的异常类型。
捕获异常后，重新抛出 runtimeexception。

推荐方式：

@transactional(rollbackfor = exception.class)
public void updateuser(user user) {
    try {
        userrepository.save(user);
    } catch (exception e) {
        log.error("更新失败", e);
        throw new runtimeexception("更新失败", e);
    }
}

1.3 事务传播行为配置不当

原因分析：

在嵌套事务中，如果内层事务使用了 propagation.requires_new，它会启动一个独立的新事务，外层事务的回滚不会影响内层事务，可能导致数据不一致。

示例代码：

@transactional(propagation = propagation.requires_new)
public void innermethod() {
    // 内层事务
}

@transactional
public void outermethod() {
    innermethod();
    throw new runtimeexception("外层异常");
}

问题：

外层事务回滚，但内层事务已提交，导致数据不一致。

解决方案：

根据业务需求选择合适的传播行为。
如果希望内外事务一致，避免使用 requires_new，改用 required。

推荐方式：

@transactional(propagation = propagation.required)
public void innermethod() {
    // 内层事务
}

@transactional
public void outermethod() {
    innermethod();
    throw new runtimeexception("外层异常");
}

1.4 数据库引擎不支持事务

原因分析：

某些数据库引擎（如 mysql 的 myisam）不支持事务，即使代码中配置了事务，也不会生效。

解决方案：

确保数据库使用支持事务的引擎，如 innodb。

1.5 事务管理器未正确配置

原因分析：

如果项目中没有正确配置事务管理器，@transactional 注解不会生效。

解决方案：

确保在配置类中配置了事务管理器，例如：

@bean
public platformtransactionmanager transactionmanager(datasource datasource) {
    return new datasourcetransactionmanager(datasource);
}

1.6 多数据源事务管理问题

原因分析：

在多数据源场景下，如果没有为每个数据源配置独立的事务管理器，事务可能会失效。

解决方案：

为每个数据源配置独立的事务管理器。
使用 @transactional(value = "transactionmanagername") 指定事务管理器。

二、如何排查事务失效问题

2.1 启用事务日志

在 application.properties 中开启事务日志：

logging.level.org.springframework.transaction=debug
logging.level.org.springframework.jdbc=debug

2.2 检查代理对象

确保事务方法是通过 spring 的代理对象调用的，而不是直接调用。

2.3 检查异常处理

确保异常被正确抛出，并符合事务回滚的条件。

2.4 检查数据库引擎

确保数据库引擎支持事务，例如使用 innodb。

三、事务传播行为（propagation）的常用类型

传播行为类型	说明
required（默认）	当前方法加入已有事务，若没有则创建新事务。
requires_new	创建新事务，并挂起当前事务。
not_supported	不支持事务，挂起当前事务。
never	不允许事务，若当前有事务则抛出异常。
supports	当前方法可以在事务中执行，也可以不在事务中执行。
mandatory	当前方法必须在事务中执行，若没有事务则抛出异常。