@Transactional 什么情况下会失效

罗将军的恩情还不完 發表於 2025-6-10 20:52:00

@Transactional 注解在 Spring 中用于声明式事务管理，但在某些场景下会失效。
<h3>1、方法非 public 修饰</h3>
<ul>
<li>原因：Spring AOP 代理（CGLIB/JDK 动态代理）无法拦截 private/protected 的方法。</li>
<li>解决：确保事务方法为 public。</li>
</ul>
<pre class="language-java highlighter-hljs"><code>// ✅ 正确
@Transactional
public void createUser() { ... }

// ❌ 失效
@Transactional
private void createUser() { ... }</code></pre>
<h3>2、自调用问题（同类内调用）</h3>
<ul>
<li>原因：类内部方法调用（如 A.a() 调用 A.b()）会绕过代理对象，导致 @Transactional 失效。</li>
<li>解决：</li>
</ul>
        ① 注入自身代理对象：@Autowired private MyService self; 后调用 self.b()。
        ② 通过 AopContext 获取代理：((MyService) AopContext.currentProxy()).b()（需开启 @EnableAspectJAutoProxy(exposeProxy = true)）。我更喜欢把逻辑写到另一个类中，然后再进行调用。
<pre class="language-java highlighter-hljs"><code>@Service
public class UserService {
@Autowired
private UserService self; // 注入自身代理

public void methodA() {
 // ❌ 直接调用失效
 // methodB();

 // ✅ 通过代理调用生效
 self.methodB();
}

@Transactional
public void methodB() { ... }
}</code></pre>
<h3>3、异常类型未被捕获</h3>
<ul>
<li>原因：</li>
</ul>
        ① 默认只捕获 <code>RuntimeException</code> 和 <code>Error</code>。
        ② 若抛出 <code>IOException</code> 等受检异常，事务不会回滚。
        ③ 若异常被 <code>catch</code> 后未重新抛出，事务失效。
<ul>
<li>解决：</li>
</ul>
        ① 使用 <code>rollbackFor</code> 指定异常类型：<code>@Transactional(rollbackFor = Exception.class)</code>
        ② 避免在方法内吞没异常。
<pre class="language-java highlighter-hljs"><code>// ✅ 回滚受检异常
@Transactional(rollbackFor = Exception.class)
public void update() throws IOException {
try {
 // 数据库操作
} catch (Exception e) {
 // ❌ 错误：吞没异常
 // log.error(e);

 // ✅ 正确：重新抛出
 throw new BusinessException(e);
}
}</code></pre>
<h3>4、数据库引擎不支持事务</h3>
<ul>
<li>
原因：如 MySQL 的 MyISAM 引擎不支持事务（仅 InnoDB 支持）。
</li>
<li>
解决：确认使用支持事务的引擎（比如 InnoDB 引擎）。
</li>
</ul>
<h3>5、事务传播行为配置不当</h3>
<ul>
<li>
原因：若内层方法使用 <code>Propagation.NOT_SUPPORTED</code> 或 <code>Propagation.NEVER</code> 等传播行为，会挂起外层事务。
</li>
<li>
解决：根据业务需求调整传播行为（如 <code>Propagation.REQUIRED</code>）。
</li>
</ul>
<pre class="language-java highlighter-hljs"><code>// ❌ 内层方法挂起事务
@Transactional(propagation = Propagation.NEVER)
public void innerMethod() { ... }</code></pre>
<h3>6、多线程调用（异步调用）</h3>
<ul>
<li>
原因：新线程内执行数据库操作不归属同一事务（事务绑定到 ThreadLocal）。异步方法（如使用 <code>@Async</code> 注解的方法）不会参与当前事务。即使该方法被 <code>@Transactional</code> 注解标记，事务也不会生效。
</li>
<li>
解决：避免跨线程操作，或手动传递事务上下文（比较复杂）。
</li>
</ul>
<h3>7、非 Spring 管理的 Bean</h3>
<ul>
<li>
原因：通过 <code>new</code> 创建的对象不受 Spring 代理管理。
</li>
<li>
解决：确保对象由 Spring 容器创建（如 <code>@Component</code>）。
</li>
</ul>
<h3>8、方法 final 或 static</h3>
<ul>
<li>
原因：CGLIB 无法代理 <code>final</code>/<code>static</code> 方法（JDK 代理无法代理 static）。
</li>
<li>
解决：避免修饰事务方法为 <code>final</code> 或 <code>static</code>。
</li>
</ul>
<h3>9、未启用事务管理</h3>
<ul>
<li>
原因：忘记添加 <code>@EnableTransactionManagement</code>（Spring Boot 中自动配置）。
</li>
<li>
解决：检查配置类是否启用事务管理。
</li>
</ul>
<h3>10、非事务性方法调用</h3>
<ul>
<li>
原因：如果在事务方法内部调用了另一个没有事务管理的方法，事务将不会传播到被调用的方法中。事务只会在当前方法的调用栈中生效。
</li>
<li>
解决：确保所有需要事务的操作都在事务方法中。
</li>
</ul>
这些都是 <code>@Transactional</code> 可能失效的常见原因。如果遇到事务失效的问题，可以逐一排查这些情况。在工作中，有时出现了数据不一致的情况，去排查才发现是事务失效了。
知是行之始，行是知之成。-- 烟沙九洲 
来源：https://www.cnblogs.com/yanshajiuzhou/p/18922768

頁: [1]

琼殿技术论坛's Archiver

@Transactional 什么情况下会失效