jooq 不支持将表名等 sql 语法元素作为绑定参数重复使用；正确做法是采用 plain sql templates 结合占位符进行预编译替换，确保同一表名在多处被一致、安全地注入。
jooq 不支持将表名等 sql 语法元素作为绑定参数重复使用；正确做法是采用 plain sql templates 结合占位符进行预编译替换，确保同一表名在多处被一致、安全地注入。
在使用 jOOQ 执行动态 SQL 时，一个常见误区是试图用 param() 绑定表名（如 :a_table），期望它像普通值参数一样在 SQL 字符串中多处自动替换。但需明确：SQL 绑定参数（bind values）仅适用于标量值（如字符串、数字、日期），不适用于语法结构（如表名、列名、关键字）。这是 JDBC 和所有主流数据库的底层限制，并非 jOOQ 的设计缺陷。
例如，以下写法是无效的：
String sql = "SELECT * FROM :table t1 JOIN :table t2 ON t1.id = t2.ref_id";
dslContext.fetch(sql, param("table", "users")); // ❌ 仅首次 :table 被替换，第二次失效jOOQ 的 param() 机制基于 JDBC PreparedStatement，而 PreparedStatement 本身禁止将表名作为参数传入——数据库驱动会在预编译阶段报错（如 ORA-00903: invalid table name 或 PSQLException: ERROR: syntax error at or near "$1"）。
✅ 正确解法：使用 Plain SQL Templates（纯 SQL 模板）
jOOQ 提供了安全的字符串模板机制，通过 {0}、{1} 等位置占位符，在 SQL 生成阶段（即 jOOQ 渲染为最终 JDBC SQL 前）完成文本替换，且自动处理标识符转义（如添加双引号、反引号），避免 SQL 注入风险。
以下是推荐实现（Java 15+ 推荐使用文本块）：
String sql = """
SELECT *
FROM {0} a
JOIN {1} b ON a.x != b.x
WHERE a.y NOT IN (
SELECT b1.y
FROM {1} b1
WHERE b1.x = a.x
)
""";
// ATable 和 BTable 必须是 org.jooq.Table<?> 类型（如由 DSL.table("schema.a_table") 构建）
return dslContext.fetch(sql, ATable, BTable);? 关键点说明：
- {0} 和 {1} 是 jOOQ 模板语法，不是 JDBC 占位符；
- ATable 和 BTable 应为 Table<?> 实例（可来自 DSL.table("my_table") 或代码生成器生成的表类），jOOQ 会自动对其执行 SQL 标识符转义（如 "my_table" 或 `my_table`），保障安全性；
- 同一占位符（如 {1}）可在模板中出现任意次数，全部被相同 Table 对象替换；
- 模板替换发生在 jOOQ 内部 SQL 渲染环节，不经过 JDBC PreparedStatement 参数化流程，因此完全规避了“绑定参数不能用于表名”的限制。
⚠️ 注意事项：
- 切勿拼接用户输入到模板字符串中（如 "{0}".formatted(userInput)），必须始终使用 Table<?> 或 Field<?> 等 jOOQ 类型作为模板参数，以启用内置转义；
- 若需动态表名但无现成 Table 实例，可用 DSL.table(name("schema", userInput)) 构造，其中 name() 支持运行时构建安全标识符；
- 避免混合使用模板与 param()：模板用于语法元素（表/列/函数名），param() 仅用于 WHERE 条件中的值、INSERT 的字段值等标量上下文。
总结：当需要在一条 SQL 中多次复用同一张表名或其它 SQL 语法成分时，放弃绑定参数思路，坚定选择 Plain SQL Templates。它既保持了动态灵活性，又继承了 jOOQ 的类型安全与防注入能力，是生产环境中处理环境相关表名（如 prod_users / stg_users）的标准实践。
