jOOQ 不支持将表名等语法元素作为绑定参数（param()）重复使用；必须改用 Plain SQL 模板（如 {0} 占位符）实现安全、可复用的动态表名注入。
jooq 不支持将表名等语法元素作为绑定参数（`param()`）重复使用；必须改用 plain sql 模板（如 `{0}` 占位符）实现安全、可复用的动态表名注入。
在使用 jOOQ 执行动态 SQL 时，一个常见误区是试图用 param("table_name", "my_table") 将表名作为绑定参数传入——这不仅无法生效，还会导致 SQL 解析异常或仅部分替换（如问题中所示：b_table 在子查询中未被替换）。根本原因在于：SQL 绑定参数（bind values）仅适用于运行时传入的标量值（如字符串、数字、日期），而表名、列名、关键字等属于 SQL 语法结构（syntactic elements），必须在 SQL 生成阶段（即编译期）确定，不能延迟到 JDBC PreparedStatement 执行时处理。
因此，jOOQ 明确区分两类机制：
- ✅ param() / bind()：用于安全传递用户数据（防 SQL 注入），仅支持标量值；
- ✅ Plain SQL Templates（模板）：使用 {0}, {1} 等位置占位符，由 jOOQ 在生成最终 SQL 前完成文本替换，支持 Table<?>, Field<?>, 甚至原生字符串（需自行确保安全性）。
正确做法：使用 Plain SQL 模板
推荐使用 Java 13+ 的文本块（Text Blocks）提升可读性，并结合 jOOQ 的类型安全表对象：
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("a_table") 或代码生成类）
return dslContext.fetch(sql, ATable, BTable);? 提示：若 ATable/BTable 是字符串而非 Table<?>，可改用 DSL.table("a_table") 包装，确保类型安全与 SQL 转义（如自动加引号）。
注意事项与最佳实践
- 安全性第一：模板中的 {0} 占位符会直接插入生成的 SQL，因此务必确保传入的 Table<?> 对象来自可信源（如配置枚举、白名单映射），切勿直接传入用户输入的字符串，否则将引发 SQL 注入风险。
- 避免手动拼接：不要用 + 拼接表名字符串（如 "FROM " + tableName），既不安全也不可维护；始终优先使用 DSL.table() + 模板。
-
环境适配建议：可将表名映射抽象为配置类，例如：
Map<String, Table<?>> TABLES = Map.of( "prod", PROD_SCHEMA.A_TABLE, "stg", STG_SCHEMA.A_TABLE, "dev", DEV_SCHEMA.A_TABLE );再按环境选择对应 Table<?> 实例传入模板。
- 调试技巧：启用 jOOQ 日志（如 logging 或 org.jooq.tools.LoggerListener）查看最终生成的 SQL，确认模板是否正确展开。
总之，面对“同一表名多次出现”的动态需求，放弃绑定参数幻想，拥抱 Plain SQL 模板——它既是 jOOQ 官方推荐方案，也是兼顾灵活性、类型安全与可维护性的最优解。
