无主键表使用Jooq更新记录时意外插入新记录的问题

你的代码逻辑本身是标准的UPDATE语句，但出现插入新记录的情况，必然是实际执行的SQL与预期不符，或是存在未注意到的隐藏逻辑。按以下步骤逐一排查：

• 第一步：查看Jooq生成的实际SQL
  开启Jooq的SQL日志，确认执行的是UPDATE还是INSERT。比如在Spring Boot项目中，可在配置文件添加：

  logging:
    level:
      org.jooq: DEBUG
  

  日志会显示Jooq生成的完整SQL语句，这是最直接的排查依据。如果日志显示的是INSERT，说明代码逻辑被意外修改（比如误调用了insert()方法）；如果是UPDATE，则继续下一步。

• 第二步：验证WHERE条件是否匹配现有记录
  手动执行SQL：SELECT * FROM result WHERE name = '你的name参数值'，确认是否存在符合条件的记录。如果没有匹配的记录，UPDATE语句不会修改任何行，但绝不会插入新记录——此时你看到的新记录大概率是其他代码逻辑插入的。

• 第三步：检查是否存在自动Upsert的配置
  确认Jooq是否被配置为自动执行Upsert（即无匹配记录时插入）。默认情况下update()方法不会触发Upsert，除非你显式调用了onDuplicateKeyUpdate()或类似方法。如果项目中有全局配置修改了Jooq的默认行为，可能导致这种异常情况。

• 第四步：验证实体类与表的映射关系
  如果Result是手动编写的实体类，检查STATUS、NAME字段的映射是否正确（比如字段名、数据类型是否和数据库表完全一致）。映射错误可能导致UPDATE语句无法匹配到目标记录，但同样不会触发插入。

另外，针对无主键表的注意事项：Jooq对无主键表的更新操作本身没有限制，只要WHERE条件能匹配到记录，就能正常更新。returning()方法会返回所有被更新的记录，如果没有更新任何行，会返回空结果，此时Mono.from(...)会发出空信号，不会触发插入逻辑。

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