SpringBoot3+Jooq自定义delete方法触发只读事务异常排查

1. 只读事务异常的原因 #

核心原因是自定义方法执行时处于Spring的只读事务上下文，导致PostgreSQL拒绝执行DELETE这类写操作。常见触发场景：

• Spring Boot测试类标注了@Transactional但未显式关闭只读属性（Spring Boot测试中@Transactional默认readOnly=true）
• 自定义方法未标注事务注解，被上层已存在的只读事务上下文覆盖
• 手动获取的DSLContext实例使用了只读连接（比如连接池默认配置为只读）

2. 自定义方法与自动生成方法的行为差异 #

Jooq自动生成的DAO类（继承DAOImpl）在Spring集成环境下有内置的事务适配逻辑：

• 自动生成的delete方法会通过SpringTransactionProvider适配当前事务状态，执行写操作时会自动确保连接处于可写模式
• 自动生成的DAO类默认被Spring事务代理管理，会根据操作类型（写操作）自动调整事务的只读属性；而自定义方法若未正确声明事务配置，会直接落入当前的只读事务上下文，触发异常

3. 修复方案 #

针对不同场景，可选择以下修复方式：

• 调整测试类事务属性：如果测试类标注了@Transactional，显式关闭只读模式：

  @SpringBootTest
  @Transactional(readOnly = false)
  class UserDaoTest {
      // 测试代码
  }
  

• 给自定义方法添加事务注解：在自定义方法所在类或方法上标注@Transactional，确保执行时处于可写事务：

  @Transactional
  public class CustomUserDao {
      private final DSLContext dsl;
  
      public CustomUserDao(DSLContext dsl) {
          this.dsl = dsl;
      }
  
      public int deleteByUsername(String username) {
          return dsl.deleteFrom(USER)
                  .where(USER.USERNAME.eq(username))
                  .execute();
      }
  }
  

• 强制开启新事务：若上层存在只读事务，可通过事务传播行为强制开启新的可写事务：

  @Transactional(propagation = Propagation.REQUIRES_NEW)
  public int deleteByUsername(String username) {
      // 实现代码
  }
  

• 检查DSLContext实例：确保注入的DSLContext是Spring集成的实例，而非手动创建的未绑定事务的独立实例

内容的提问来源于stack exchange，提问作者Chuck1sn