避坑 | @Transactional注解下，事务失效的10种场景

在Java应用程序中，Spring框架的事务管理是确保数据完整性和一致性的核心机制之一。然而，在使用Spring的@Transactional注解时，开发人员经常会面临一些可能导致事务失效的场景，从而影响系统的可靠性和稳定性。
本文将深入探讨十种常见场景，并提供详细的解释和代码示例，以帮助大家更好地理解并避免这些问题的发生。

1. 异常被捕获并处理

在@Transactional注解标记的方法内部抛出异常，但在try-catch块中被捕获并处理时，事务可能会失效。由于异常被捕获，事务管理器无法感知异常的抛出，从而无法触发事务回滚。

@Transactional
public void updateData() {
    try {
        // 可能会抛出异常的操作
    } catch (Exception ex) {
        // 异常被捕获并处理
    }
}

2. 抛出的异常为受检查异常

如果在@Transactional注解标记的方法内部抛出了受检查异常，而不是RuntimeException或其子类，事务可能会失效。需要额外的配置才能使受检查异常触发事务回滚。

//@Transactional(rollbackFor = Exception.class)//表示该方法的事务在抛出任何异常时都进行回滚
@Transactional
public void loadData() throws SQLException {
    // 可能会抛出受检查异常的操作
}

3. 方法内部直接调用另一个方法

如果在@Transactional注解标记的方法内部直接调用另一个方法，并且被调用的方法中存在事务操作，但调用是直接的而不是通过代理对象，事务可能会失效。

@Transactional
public void performTransaction() {
    // 可能调用其他方法的操作
    anotherMethod(); // 直接调用另一个方法
}

@Transactional
public void anotherMethod() {
    // 另一个方法可能包含事务操作
}

因为，当你使用@Transactional注解标记一个方法时，Spring会为这个方法创建一个事务代理。这个代理会在方法执行前后负责管理事务。但是，如果你在被@Transactional注解标记的方法内部直接调用另一个方法，而不是通过代理对象调用，那么事务可能会失效，因为Spring无法感知到这个直接的方法调用。

为了解决这个问题，可以这样做：

（1）通过代理对象调用方法：可以注入当前类的代理对象，并使用代理对象来调用另一个方法。这样Spring就能正确地管理被调用方法中的事务。

@Resource
private YourClassName proxy;

@Transactional
public void performTransaction() {
    // 可能调用其他方法的操作
    proxy.anotherMethod(); // 通过代理对象调用另一个方法
}

@Transactional
public void anotherMethod() {
    // 另一个方法可能包含事务操作
}

（2）将方法移到另一个类中：你可以将被调用的方法移到另一个类中，并从performTransaction()方法中通过代理对象调用它。

@Transactional
public void performTransaction() {
    // 可能调用其他方法的操作
    anotherService.anotherMethod(); // 通过代理对象调用另一个方法
}

public class AnotherService {
    @Transactional
    public void anotherMethod() {
        // 另一个方法可能包含事务操作
    }
}

4. 方法为非public

如果@Transactional注解应用在非public方法上，则事务可能会失效。因为Spring AOP默认情况下只会代理public方法。

@Transactional
private void internalOperation() {
    // 非public方法
}

5. 错误的传播特性设置

当@Transactional注解的传播行为设置错误时，事务可能会失效。以下是几种常见的传播特性：

• REQUIRED：如果当前存在事务，则加入该事务；如果当前没有事务，则创建一个新的事务。
• REQUIRES_NEW：创建一个新的事务，并且暂停当前正在执行的事务（如果存在）。
• SUPPORTS：如果当前存在事务，则加入该事务；如果当前没有事务，则以非事务的方式执行。
• NOT_SUPPORTED：以非事务的方式执行操作，如果当前存在事务，则将其挂起。
• MANDATORY：如果当前存在事务，则加入该事务；如果当前没有事务，则抛出异常。
• NEVER：以非事务的方式执行操作，如果当前存在事务，则抛出异常。
• NESTED：如果当前存在事务，则在嵌套事务内执行；如果当前没有事务，则创建一个新的事务。

@Service
public class OrderServiceImpl {

    @Transactional(propagation = Propagation.NEVER)//以非事务的方式执行操作
    public void cancelOrder(UserModel userModel) {
        // 取消订单
        cancelOrder(orderDTO);
        // 还原库存
        restoreProductStock(orderDTO.getProductId(), orderDTO.getProductCount());
    }
}

6. 多线程环境下调用事务方法

如果在多线程环境下调用事务方法，并且这些方法不是在同一个线程中执行，事务可能会失效。由于事务管理是基于线程的，所以在updateData()方法内部启动的新线程将无法访问processInThread()方法的事务。因此，updateData()方法中的数据库操作将不会被纳入到任何事务中，导致事务失效。

@Transactional
public void processInThread() {
    // 在多线程中调用事务方法的操作
    new Thread(() -> {
        // 在新线程中执行事务方法
        updateData();
    }).start();
}

7. 数据库引擎不支持事务

如果使用的数据库引擎不支持事务，如MyISAM，事务将会失效。因为这些数据库引擎不支持事务操作。

CREATE TABLE my_table (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(255)
) ENGINE = MyISAM; -- MyISAM 不支持事务

8. 事务方法未被Spring管理

如果事务方法所在的类没有注册到Spring IOC容器中，即没有被Spring管理，则Spring事务会失效。

//@Service//未被IOC容器管理
public class ProductServiceImpl extends ServiceImpl<ProductMapper, Product> implements IProductService {

    @Autowired
    private ProductMapper productMapper;

    @Override
    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void updateProductStockById(Integer stockCount, Long productId) {
        productMapper.updateProductStockById(stockCount, productId);
    }
}

9. 方法使用final类型修饰

如果将事务方法定义成final，Spring事务会失效。因为在代理类中无法重写final修饰的方法，从而无法添加事务功能。

@Service
public class OrderServiceImpl {

    @Transactional
    public final void cancel(OrderDTO orderDTO) {
        // 取消订单
        cancelOrder(orderDTO);
    }
}

10. 未配置开启事务

如果项目中没有配置Spring的事务管理器，即使使用了Spring的事务管理功能，Spring的事务也不会生效。

@Configuration
@EnableTransactionManagement
public class AppConfig {

    @Bean
    public DataSource dataSource() {
        // 配置数据源
        return new DataSource();
    }

    @Bean
    public PlatformTransactionManager transactionManager() {
        // 配置事务管理器
        return new DataSourceTransactionManager(dataSource());
    }
}

以上是Spring事务失效的十种常见场景及相应的解释和代码示例。在实际开发中，了解并避免这些情况的发生，将有助于确保系统数据的完整性和一致性，提高系统的稳定性和可靠性。
通过遵循最佳实践和精心配置，开发人员可以确保Spring事务管理在应用程序中的有效运行，从而确保系统在各种情况下都能保持数据的完整性和一致性。