当前位置：首页 > news >正文

Java + Spring Boot + MyBatis 事务注解 @Transactional 使用规范说明

news 来源：原创 2025/6/13 12:11:56

在Spring Boot + MyBatis项目中，并非每个Service方法都需要添加@Transactional注解。是否添加该注解取决于具体业务场景和操作需求。以下是详细分析：

一、必须使用`@Transactional`的场景

多数据库操作需原子性
当方法内包含多个数据库写操作（如多个INSERT/UPDATE/DELETE），且需要保证这些操作要么全部成功，要么全部失败时，必须使用事务。
示例：转账操作（扣款+加款）

java

复制

下载
```
@Transactional
public void transferMoney(Long from, Long to, BigDecimal amount) {accountMapper.deduct(from, amount);// 此处若发生异常，扣款操作会回滚accountMapper.add(to, amount);
}
```
跨Service方法调用
如果Service方法A调用了其他Service方法B和C，且这些操作需要作为一个整体，则应在A上添加事务注解。

二、无需使用`@Transactional`的场景

单一查询操作
纯查询方法（SELECT）通常不需要事务。但若要求强一致性（如避免脏读），可添加只读事务：

java

复制

下载
```
@Transactional(readOnly = true) // 优化性能，避免写锁
public User getUserById(Long id) {return userMapper.selectById(id);
}
```
单一写操作
如果方法仅含一个写操作（如单个INSERT），数据库本身已保证原子性，可不加事务。

注意：某些场景仍需事务（如需要回滚后续非DB操作）。
非数据库操作
方法内无任何数据库操作（如计算逻辑、调用外部API）时，不需要事务。

三、最佳实践建议

在Service层添加注解
事务注解应加在Service层而非Mapper层，确保业务逻辑完整性。

显式配置事务属性
明确指定传播行为、隔离级别、超时时间等：

java

复制

下载

@Transactional(propagation = Propagation.REQUIRED, // 默认：当前有事务则加入，无则新建isolation = Isolation.DEFAULT,       // 使用数据库默认隔离级别timeout = 30,                       // 超时时间（秒）rollbackFor = Exception.class       // 指定回滚的异常类型
)
public void businessMethod() { ... }

避免事务滥用
不必要的事务会增加性能开销（如获取/释放连接、事务同步等）。
只读查询显式标记
查询方法建议添加@Transactional(readOnly = true)，帮助数据库优化执行。

四、常见误区

误区：所有方法都加事务更“安全”。
纠正：过度使用事务可能导致死锁、性能下降、连接池耗尽等问题。
误区：事务能解决所有一致性需求。
纠正：分布式场景需结合分布式事务（如Seata）或最终一致性方案。

五、总结

场景	是否需要`@Transactional`
多数据库写操作	✅ 必须
跨方法组合操作	✅ 必须
单一查询（强一致性要求）	⚠️ 建议只读事务
单一写操作（仅1次INSERT/UPDATE）	❌ 通常不需要
非数据库操作	❌ 不需要