@Transactional 什么情况下会失效
@Transactional 注解在 Spring 中用于声明式事务管理,但在某些场景下会失效。
1、方法非 public 修饰
- 原因:Spring AOP 代理(CGLIB/JDK 动态代理)无法拦截 private/protected 的方法。
- 解决:确保事务方法为 public。
// ✅ 正确
@Transactional
public void createUser() { ... }// ❌ 失效
@Transactional
private void createUser() { ... }
2、自调用问题(同类内调用)
- 原因:类内部方法调用(如 A.a() 调用 A.b())会绕过代理对象,导致 @Transactional 失效。
- 解决:
① 注入自身代理对象:@Autowired private MyService self; 后调用 self.b()。
② 通过 AopContext 获取代理:((MyService) AopContext.currentProxy()).b()(需开启 @EnableAspectJAutoProxy(exposeProxy = true))。我更喜欢把逻辑写到另一个类中,然后再进行调用。
@Service
public class UserService {@Autowiredprivate UserService self; // 注入自身代理public void methodA() {// ❌ 直接调用失效// methodB(); // ✅ 通过代理调用生效self.methodB(); }@Transactionalpublic void methodB() { ... }
}
3、异常类型未被捕获
- 原因:
① 默认只捕获 RuntimeException
和 Error
。
② 若抛出 IOException
等受检异常,事务不会回滚。
③ 若异常被 catch
后未重新抛出,事务失效。
- 解决:
① 使用 rollbackFor
指定异常类型:@Transactional(rollbackFor = Exception.class)
② 避免在方法内吞没异常。
// ✅ 回滚受检异常
@Transactional(rollbackFor = Exception.class)
public void update() throws IOException {try {// 数据库操作} catch (Exception e) {// ❌ 错误:吞没异常// log.error(e); // ✅ 正确:重新抛出throw new BusinessException(e); }
}
4、数据库引擎不支持事务
-
原因:如 MySQL 的 MyISAM 引擎不支持事务(仅 InnoDB 支持)。
-
解决:确认使用支持事务的引擎(比如 InnoDB 引擎)。
5、事务传播行为配置不当
-
原因:若内层方法使用
Propagation.NOT_SUPPORTED
或Propagation.NEVER
等传播行为,会挂起外层事务。 -
解决:根据业务需求调整传播行为(如
Propagation.REQUIRED
)。
// ❌ 内层方法挂起事务
@Transactional(propagation = Propagation.NEVER)
public void innerMethod() { ... }
6、多线程调用(异步调用)
-
原因:新线程内执行数据库操作不归属同一事务(事务绑定到 ThreadLocal)。异步方法(如使用
@Async
注解的方法)不会参与当前事务。即使该方法被@Transactional
注解标记,事务也不会生效。 -
解决:避免跨线程操作,或手动传递事务上下文(比较复杂)。
7、非 Spring 管理的 Bean
-
原因:通过
new
创建的对象不受 Spring 代理管理。 -
解决:确保对象由 Spring 容器创建(如
@Component
)。
8、方法 final 或 static
-
原因:CGLIB 无法代理
final
/static
方法(JDK 代理无法代理 static)。 -
解决:避免修饰事务方法为
final
或static
。
9、未启用事务管理
-
原因:忘记添加
@EnableTransactionManagement
(Spring Boot 中自动配置)。 -
解决:检查配置类是否启用事务管理。
10、非事务性方法调用
-
原因:如果在事务方法内部调用了另一个没有事务管理的方法,事务将不会传播到被调用的方法中。事务只会在当前方法的调用栈中生效。
-
解决:确保所有需要事务的操作都在事务方法中。
这些都是 @Transactional
可能失效的常见原因。如果遇到事务失效的问题,可以逐一排查这些情况。在工作中,有时出现了数据不一致的情况,去排查才发现是事务失效了。
知是行之始,行是知之成。-- 烟沙九洲