Spring事务回滚：小白也能懂的避坑指南

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

   创建一个交互式学习模块，通过以下步骤帮助新手理解事务回滚：1. 最简单的@Transactional示例 2. 故意制造unchecked异常触发回滚 3. 演示try-catch吞掉异常导致rollback-only 4. 逐步修复过程。要求：每个步骤都有可运行的代码片段和实时可视化的事务状态展示，使用最简化的Kimi-K2解释说明。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果

最近在学Spring事务时遇到了一个报错：transaction silently rolled back because it has been marked as rollback-only，作为新手完全看不懂。经过一番摸索，终于搞明白了这个问题的来龙去脉，记录下这个学习过程。

1. 最简单的@Transactional示例

刚开始学习Spring事务时，最基础的就是在方法上添加@Transactional注解。这个注解会让方法在一个事务中执行，如果方法执行成功则提交事务，如果抛出异常则回滚事务。

在实际项目中，我们可能会这样使用：在一个服务方法中调用多个数据库操作，确保这些操作要么全部成功，要么全部失败回滚。这是事务的ACID特性中最基本的原子性体现。

2. 故意制造unchecked异常触发回滚

为了理解事务回滚机制，我尝试在事务方法中故意抛出运行时异常（unchecked exception）。按照Spring的默认行为，遇到RuntimeException时会自动回滚事务。这个实验很直观地展示了事务回滚的效果，数据库中的操作确实被撤销了。

这里需要注意的是，Spring默认只对unchecked异常（RuntimeException及其子类）进行回滚，对于checked异常（比如IOException）默认是不回滚的。如果需要改变这个行为，可以通过@Transactional的rollbackFor参数来指定。

3. try-catch吞掉异常导致rollback-only

问题就出现在这里：当我尝试在事务方法内部捕获异常并处理时，意外触发了rollback-only错误。具体场景是外层方法开启事务，内层方法也开启事务（默认是REQUIRED传播级别），内层方法抛出异常被我的try-catch捕获处理，这时事务就被标记为rollback-only了。

这个机制的原因是：虽然我捕获了异常，但事务管理器已经知道发生了异常情况，它认为这个事务应该被回滚。如果这时外层方法继续执行并试图提交事务，就会遇到矛盾 - 事务已经被标记为只能回滚，但代码却要提交它，于是Spring就抛出这个warning。

4. 逐步修复过程

解决这个问题的思路有几个方向：

1. 最简单的办法是让异常正常抛出，不要在事务方法内部捕获处理。让事务的边界方法统一处理异常。

2. 如果确实需要捕获处理，可以在catch块中手动设置事务状态为回滚：TransactionAspectSupport.currentTransactionStatus().setRollbackOnly()。这样明确告诉事务管理器这个事务应该回滚。

3. 调整事务传播行为，比如在内层方法使用REQUIRES_NEW创建一个新事务，这样内层事务的回滚不会影响外层事务。

4. 检查业务逻辑，看是否真的需要在事务方法内部捕获异常。很多时候，异常应该被抛出到事务边界统一处理。

经过反复试验，我选择了第二种方案，因为我的业务场景确实需要在特定情况下捕获异常并继续执行其他逻辑。明确设置回滚状态后，警告信息消失了，事务行为也符合预期。

经验总结

通过这个问题的排查，我学到了几个重要的知识点：

1. Spring事务的默认回滚规则是只对RuntimeException回滚。

2. 在事务方法内部捕获异常要特别小心，可能会干扰事务的正常流程。

3. 事务传播行为的不同设置会带来完全不同的效果。

4. 理解rollback-only标记的含义很重要，它表示事务已经决定要回滚，不能再提交。

对于想快速实践这些知识点的同学，可以试试InsCode(快马)平台，它提供了在线的Spring环境，可以直接运行测试事务相关的代码，还能看到实时的执行效果。我测试时发现它的响应速度很快，不用配置本地环境就能验证想法，特别适合新手做实验。

遇到问题不要怕，多动手实验，慢慢就能理解Spring事务的这些特性了。

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

   创建一个交互式学习模块，通过以下步骤帮助新手理解事务回滚：1. 最简单的@Transactional示例 2. 故意制造unchecked异常触发回滚 3. 演示try-catch吞掉异常导致rollback-only 4. 逐步修复过程。要求：每个步骤都有可运行的代码片段和实时可视化的事务状态展示，使用最简化的Kimi-K2解释说明。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果