jOOQ DSLContext.update生成全限定列名SQL触发PostgreSQL语法异常求助

问题根因 #

PostgreSQL语法规范中，UPDATE语句的SET子句不允许列名携带schema前缀，你异常SQL中"abc"."test"."column1"的写法会被PostgreSQL错误识别为test表下名为abc.test.column1的列，所以抛出列不存在的语法错误。

正常情况下jOOQ不会在UPDATE SET子句中生成全限定列名，偶发出现通常是以下两类原因：

• 你使用的jOOQ版本存在已知的SQL渲染逻辑bug，特定并发场景下会错误生成全限定列名
• 共享的DSLContext实例配置被意外修改：jOOQ的DefaultConfiguration是可变对象，如果有业务代码在请求处理过程中直接修改了共享DSLContext的renderQualifiedNames等渲染配置，会导致其他并发请求生成的SQL语法异常，完全符合偶发、无法复现的特征。

修复方案 #

立即规避写法 #

两种写法都可以从业务层面彻底避免该问题：

1. 改用单字段set写法，该写法的jOOQ渲染逻辑更稳定：

dslContext.update(Tables.TEST)
        .set(Tables.TEST.COLUMN1, col1)
        .set(Tables.TEST.COLUMN2, col2)
        .where(Tables.TEST.COLUMN3.eq(col3))
        .execute();

2. 显式给表设置别名，从根源上避免全限定列名生成：

Test t = Tables.TEST.as("t");
dslContext.update(t)
        .set(row(t.COLUMN1, t.COLUMN2), row(col1, col2))
        .where(t.COLUMN3.eq(col3))
        .execute();

根因排查建议 #

• 升级jOOQ到对应大版本的最新稳定小版本，这类偶发SQL渲染bug通常官方会在后续迭代中修复，无需修改业务代码
• 排查所有DSLContext相关的配置代码，禁止直接修改共享DSLContext实例的配置，如果需要临时调整渲染规则，必须使用configuration.derive()方法生成新的独立配置实例，避免影响其他请求
• 生产环境开启jOOQ的DEBUG日志打印生成的SQL，方便后续如果再出现问题快速定位上下文，Spring Boot配置参考：

spring:
  jooq:
    sql-dialect: postgresql
logging:
  level:
    org.jooq: DEBUG

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