jOOQ 不支持将绑定参数（bind parameter）用于表名等 SQL 语法元素，因其本质是 JDBC 标量值占位符；正确方案是使用 jOOQ 的纯 SQL 模板（Plain SQL Templates），通过 {0}、{1} 等位置占位符实现表名的多次、安全替换。
jooq 不支持将绑定参数（bind parameter）用于表名等 sql 语法元素，因其本质是 jdbc 标量值占位符；正确方案是使用 jooq 的纯 sql 模板（plain sql templates），通过 `{0}`、`{1}` 等位置占位符实现表名的多次、安全替换。
在使用 jOOQ 构建动态 SQL 时，一个常见误区是试图用 param() 绑定表名（如 :a_table），期望它在查询中所有出现位置都被统一替换。但这是技术上不可行的：JDBC 规范与绝大多数数据库引擎均不支持将预编译参数（? 或命名参数）用于标识符（identifier）——包括表名、列名、Schema 名等语法结构。绑定参数仅适用于标量值（如 WHERE id = ?、ORDER BY ? ❌ 不合法），而 FROM :table_name 属于语法层面的动态重构，必须在 SQL 字符串生成阶段完成，而非执行阶段。
✅ 正确解法：使用 jOOQ 的 Plain SQL Templates
该机制专为动态 SQL 模板设计，支持位置占位符（如 {0}、{1}）或命名占位符（如 {tableA}），并在 jOOQ 内部生成最终 SQL 时进行字符串替换（非 JDBC 绑定），完全绕过 JDBC 参数限制，同时保留类型安全与 SQL 注入防护（前提是传入的是 Table<?> 实例，而非原始字符串）。
以下是推荐实现方式（基于 Java 13+ 文本块 + jOOQ 3.14+）：
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
)
""";
// ✅ 安全传入 Table 对象（自动转义、防注入）
return dslContext.fetch(sql, ATable, BTable);⚠️ 关键注意事项：
- 占位符 {0}、{1} 是位置式模板变量，对应 fetch() 方法后续参数顺序；
- 必须传入 org.jooq.Table<?> 类型对象（如 ATable、BTable），jOOQ 会自动将其渲染为带引号的安全标识符（例如 "my_schema"."a_table"）；
- ❌ 切勿传入字符串字面量（如 "a_table"），否则将失去 SQL 转义保护，引发注入风险；
- 若需重用同一张表多次（如示例中 b_table 出现两次），只需在模板中重复引用 {1}，无需额外参数；
- 支持命名模板（需启用 Settings.withRenderNamedParams(true) 并使用 {tableA} 语法），但位置模板更简洁、兼容性更好。
? 进阶提示：对于跨环境（dev/stg/prod）的表名切换，建议将 Table<?> 实例封装为配置驱动的工厂方法，例如：
Table<?> getBTable() {
return switch (env) {
case "prod" -> Tables.B_TABLE_PROD;
case "stg" -> Tables.B_TABLE_STG;
default -> Tables.B_TABLE_DEV;
};
}再代入模板调用：dslContext.fetch(sql, ATable, getBTable())，实现环境隔离与逻辑解耦。
总结：jOOQ 的 param() 仅用于值绑定，表名等语法元素必须交由 Plain SQL Templates 处理。掌握这一区分，是写出健壮、可维护动态 SQL 的关键前提。
