Spring Boot @Transactional异常时数据库插入不回滚问题排查

1. 事务注解有效性检查 #

• 先核对Service方法上的@Transactional配置：
  • 必须指定rollbackFor包含你的自定义异常，比如@Transactional(rollbackFor = CustomException.class)——Spring默认只对RuntimeException/Error触发回滚
  • 方法必须是public的，Spring事务代理仅对public方法生效
  • 避免同类内部无注解方法调用有注解方法，这种场景会绕过事务代理，导致事务不生效

2. jOOQ 与 Spring 事务绑定检查 #

• 确认配置类中DefaultDSLContext是基于Spring管理的数据源/事务管理器创建的，禁止手动new独立的DSLContext实例，否则会脱离Spring事务管控
• 排查是否使用TransactionAwareDataSourceProxy包装数据源，确保jOOQ操作能感知Spring事务上下文

3. Oracle 数据库端排查 #

• 检查表或关联触发器是否使用了自治事务（Autonomous Transaction）——这类事务会独立提交，完全不受Spring回滚指令影响
• 确认表不是只读状态，Oracle只读表无法执行回滚操作
• 核对事务隔离级别，虽然Oracle默认是READ COMMITTED，但如果被修改为不支持事务的级别也会导致回滚失效

4. 异常处理的隐藏坑 #

• 检查全局异常处理器（比如@RestControllerAdvice）是否提前捕获异常且未重新抛出——事务代理感知不到异常，就不会触发回滚逻辑
• 自定义异常需是RuntimeException子类，或被@Transactional的rollbackFor明确指定，否则Spring不会识别为回滚触发条件

5. 日志与事务状态验证 #

• 别只看“事务回滚”的日志，要确认该日志对应当前操作的事务：可在Service中打印TransactionSynchronizationManager.getCurrentTransactionName()或事务ID，验证是否为同一事务
• 若存在多数据源配置，检查操作的数据源与事务管理器绑定的数据源是否一致，串数据源会直接导致回滚无效

6. jOOQ 操作的边界问题 #

• Repository中禁止手动调用commit()/rollback()，这类操作会直接接管事务，覆盖Spring的事务配置
• 确认jOOQ的TransactionProvider是Spring兼容的实现，避免自定义Provider导致事务脱节

内容的提问来源于stack exchange，提问作者Nhân Nguyễn