为什么不推荐使用@Transactional声明事务 - 文章 - 开发者社区

在日常 Spring 开发中，我们经常看到如下代码：

@Transactional
public void saveUser(User user) {
    userRepository.save(user);
    log.info("User saved");
}

只需一个注解 @Transactional，开发者就可以轻松开启事务。它用起来确实简单，但你是否真正了解它的工作原理？在一些复杂或易变的业务场景中，@Transactional 其实并不是最佳选择。本文将介绍 Spring 的两种事务管理方式，并解释为什么你可能不该总是依赖 @Transactional。

一、Spring 中的事务管理方式

Spring 提供两种主要的事务管理方式：

方式	使用形式	常见场景
声明式事务管理（@Transactional）	使用注解在方法或类上标记	简单业务逻辑、标准的业务服务层
编程式事务管理（TransactionTemplate）	显式调用模板执行事务	复杂逻辑、多事务组合、可控性强的场景

二、@Transactional 注解简介

示例代码

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    @Transactional
    public void createUser(User user) {
        userRepository.save(user);
        // 模拟异常
        if (true) {
            throw new RuntimeException("模拟异常");
        }
    }
}

顺便吆喝一句，技术大厂前后端测试捞人，待遇还可以，感兴趣seesee~

🧨 潜在问题

1. 内部方法调用无效

@Service
public class OrderService {

    public void outerMethod() {
        innerTransactionalMethod(); // 无效！
    }

    @Transactional
    public void innerTransactionalMethod() {
        // 事务不会生效
    }
}

2. 默认异常行为不直观

@Transactional
public void updateUser() throws IOException {
    userRepository.save(user);
    throw new IOException(); // 不会回滚！
}

3. 不适用于异步/多线程环境

事务只对当前线程有效，线程池或异步任务中的事务不会自动传播。

4.不适用于方法中含有远程调用的业务

@Transactional
public void updateUser() throws IOException {
    userRepository.save(user);
    // 远程调用消息服务
    messageApi.sendMessage(user); //远程调用不受事务控制，可能导致事务超时或数据不一致
}

三、TransactionTemplate 编程式事务管理

示例代码

@Service
public class UserService {

    @Autowired
    private TransactionTemplate transactionTemplate;

    @Autowired
    private UserRepository userRepository;

    public void createUser(User user) {
        transactionTemplate.executeWithoutResult(status -> {
            try {
                userRepository.save(user);
                if (true) throw new RuntimeException("模拟异常");
            } catch (Exception e) {
                status.setRollbackOnly();
                throw e;
            }
        });
    }
}

✅ TransactionTemplate 优势

事务边界明确
控制更细粒度
无代理问题
适用于嵌套事务和多线程环境

四、对比总结

特性	@Transactional	TransactionTemplate
使用简便性	⭐⭐⭐⭐⭐	⭐⭐
灵活性	⭐⭐	⭐⭐⭐⭐⭐
异常控制	⭐⭐（需配置）	⭐⭐⭐⭐⭐（手动）
内部方法事务	❌（无效）	✅
代码清晰度	⭐⭐⭐	⭐⭐⭐⭐⭐
多线程支持	❌	✅（手动管理）

五、那应该什么时候用哪一个？

✅ 使用 @Transactional 的场景

简单业务逻辑
控制流程较清晰
能处理其局限性

✅ 使用 TransactionTemplate 的场景

复杂事务逻辑
多个事务组合或嵌套调用
内部调用或异步任务
对异常控制和事务边界要求更高

六、结语：更推荐用 TransactionTemplate 的理由

虽然 @Transactional 看起来更优雅，但它隐藏了很多细节和坑，在中大型项目或高复杂度业务系统中，这种“隐藏的魔法”常常导致不可预期的结果。而 TransactionTemplate 虽然代码更多，却明确可控，更适合团队协作、复杂流程、以及代码可读性更重要的场合。

优雅不是省代码，而是写出“让人一眼看懂”的逻辑。

当然了，如果你的团队中每个人都能避免@Transactional 潜在的问题，那么使用@Transactional 也没有问题，这是比较理想的情况

——转载自：DashBoot