你是否曾在 Spring 项目中遇到过事务失效的“灵异事件”？明明加了 @Transactional 注解，事务却莫名其妙地不生效？作为一名“久经沙场”的大龄程序员，我深知事务失效的痛点和陷阱。本文将带你深入剖析 Spring 事务失效的六大原因，并提供实用的解决方案，助你轻松避坑，成为事务管理的“老司机”！

1. 事务失效的“头号杀手”：代理机制失效

问题描述

Spring 的事务管理是通过代理机制实现的。如果你在同一个类中直接调用事务方法（例如通过 this 调用），代理机制会失效，事务也不会生效。

示例代码

@Service
public class UserService {

    @Transactional
    public void createUser() {
        // 业务逻辑
        this.updateUser(); // 直接调用，事务失效
    }

    @Transactional
    public void updateUser() {
        // 业务逻辑
    }
}

解决方法

• 使用 AopContext.currentProxy() 获取代理对象：
• ((UserService) AopContext.currentProxy()).updateUser();
• 通过依赖注入调用自身：
• @Autowired private UserService self; // 注入自身 self.updateUser();

2. 事务传播机制配置错误

问题描述

Spring 提供了多种事务传播机制（如 REQUIRED、REQUIRES_NEW 等）。如果配置不当，可能会导致事务嵌套或独立事务失效。

示例代码

@Transactional(propagation = Propagation.REQUIRED)
public void outerMethod() {
    innerMethod(); // 内层事务
}

@Transactional(propagation = Propagation.REQUIRES_NEW)
public void innerMethod() {
    // 业务逻辑
}

解决方法

• 根据业务需求正确配置传播机制。
• 使用 REQUIRES_NEW 时，确保内层事务独立执行。

3. 异常被“吞掉”导致事务不回滚

问题描述

默认情况下，Spring 只对 RuntimeException 和 Error 回滚事务。如果捕获了异常但没有重新抛出，事务不会回滚。

示例代码

@Transactional
public void createOrder() {
    try {
        // 业务逻辑
    } catch (Exception e) {
        // 捕获异常但不抛出，事务不回滚
        e.printStackTrace();
    }
}

解决方法

• 在捕获异常后重新抛出：
• throw new RuntimeException(e);
• 使用 @Transactional(rollbackFor = Exception.class) 指定回滚的异常类型。

4. 事务超时时间过短

问题描述

如果事务执行时间超过了设置的超时时间，事务会被强制回滚，导致事务失效。

示例代码

@Transactional(timeout = 2) // 超时时间为 2 秒
public void processData() {
    // 耗时操作
    Thread.sleep); // 超过超时时间
}

解决方法

• 根据业务需求合理设置超时时间：
• @Transactional(timeout = ) // 设置为 秒
• 将耗时操作移到事务外部或使用异步任务。

5. 非 public 方法导致事务失效

问题描述

Spring 的事务代理只能作用于 public 方法。如果事务方法是非 public 的，事务会失效。

示例代码

@Transactional
private void internalMethod() {
    // 业务逻辑
}

解决方法

• 确保事务方法是 public 的：
• @Transactional public void publicMethod() { // 业务逻辑 }

6. 多数据源配置错误

问题描述

在多数据源场景下，如果未正确配置事务管理器，可能会导致事务失效。

解决方法

• 为每个数据源配置独立的事务管理器：
• @Bean public PlatformTransactionManager transactionManager(DataSource dataSource) { return new DataSourceTransactionManager(dataSource); }
• 在 @Transactional 中指定事务管理器：
• @Transactional("transactionManager")

总结

Spring 事务失效的原因多种多样，但归根结底，都是由于对 Spring 事务机制的理解不够深入。通过本文的解析，相信你已经掌握了事务失效的常见原因及解决方法。记住以下几点：

1. 理解代理机制：避免直接调用事务方法。
2. 合理配置传播机制：根据业务需求选择正确的传播行为。
3. 正确处理异常：确保异常能够触发回滚。
4. 关注方法可见性：事务方法必须是 public 的。
5. 多数据源配置：确保事务管理器正确配置。

事务管理是 Spring 开发中的核心技能之一，掌握这些技巧，你将能够轻松应对复杂的业务场景，成为团队中的“事务专家”！