在JOOQ的insertInto().values()中使用DSL.param()的原因是什么？

常规场景下属于冗余写法 #

你给出的直接传入实际值的写法是JOOQ官方推荐的常规用法。默认配置下，JOOQ会自动把直接传入values()的字面量处理为预编译参数，不会直接拼接进SQL，不存在SQL注入风险，执行效果和手动套DSL.param()完全一致。你当前贴出的插入逻辑如果没有配套的特殊处理，这种DSL.param()的写法确实是不必要的冗余。

DSL.param()的实际适用场景 #

这种写法只在以下特定场景下有实际作用：

• 复用SQL执行计划：如果业务需要批量执行大量结构完全一致、仅参数值不同的SQL，手动指定具名参数可以让JOOQ生成完全相同的预编译SQL模板，数据库端可以复用执行计划，大幅提升批量操作的性能。比如循环插入上千条用户数据时，固定名称的参数会让生成的SQL统一为insert into user(first_name,last_name) values (?,?)，不需要数据库每次重新解析SQL。
• 动态修改已构造的SQL参数：如果项目中SQL构造和执行是拆分的两个步骤（比如提前构造好通用Insert语句存入缓存，后续执行时再传入不同参数），可以通过Query.getParam()获取你指定名称的参数，动态修改取值，不需要重新构造整个DSL语句。
• 强制参数绑定规则：部分特殊配置下（比如全局配置了settings.withStatementType(StatementType.STATIC_STATEMENT)让JOOQ默认拼接常量到SQL），手动用DSL.param()可以强制指定当前位置为预编译参数，规避SQL注入或者类型转换问题。
• 适配自定义扩展逻辑：如果你们项目有自定义的JOOQ拦截器、SQL审计组件，是按参数名来提取、记录入参的，手动指定param的名称可以统一参数标识，方便通用逻辑处理。

优化建议 #

如果你们项目没有以上特殊需求，可以直接改成直接传值的写法，代码更简洁，执行效果和原有写法没有任何差异。

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