@Transactional 注解在 Spring 中用于声明式事务管理,但在某些场景下会失效。
1、方法非 public 修饰
- 原因: Spring AOP 代理(CGLIB/JDK 动态代理)无法拦截 private/protected 的方法。
- 解决: 确保事务方法为 public。
java
// ✅ 正确
@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))。我更喜欢把逻辑写到另一个类中,然后再进行调用。
-
java
@Service
public class UserService {
@Autowired
private UserService self; // 注入自身代理
public void methodA() {
// ❌ 直接调用失效
// methodB();
// ✅ 通过代理调用生效
self.methodB();
}
@Transactional
public void methodB() { ... }
}
3、异常类型未被捕获
-
原因:
-
默认只捕获
RuntimeException
和Error
。 -
若抛出
IOException
等受检异常,事务不会回滚。 -
若异常被
catch
后未重新抛出,事务失效。
-
-
解决:
-
使用
rollbackFor
指定异常类型:@Transactional(rollbackFor = Exception.class)
-
避免在方法内吞没异常。
-
java
// ✅ 回滚受检异常
@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
)。
java
// ❌ 内层方法挂起事务
@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
可能失效的常见原因。如果遇到事务失效的问题,可以逐一排查这些情况。在工作中,有时出现了数据不一致的情况,去排查才发现是事务失效了。
知是行之始,行是知之成。-- 烟沙九洲