jOOQ 对 Condition 类型的原生 SQL 模板默认添加括号以保障运算符优先级安全；若需去除冗余括号（如 WHERE (address = decode(...)) → WHERE address = decode(...)），应改用 Field.eq() 组合 field() 函数，而非 condition()。
jooq 对 `condition` 类型的原生 sql 模板默认添加括号以保障运算符优先级安全；若需去除冗余括号（如 `where (address = decode(...))` → `where address = decode(...)`），应改用 `field.eq()` 组合 `field()` 函数，而非 `condition()`。
在使用 jOOQ 编写 PostgreSQL 特有函数（如 decode()）时，开发者常希望通过原生 SQL 模板实现灵活查询，但会意外发现生成的 SQL 多出一对圆括号——例如：
WHERE ( 'address' = decode('0x159159159526212521', 'escape') )而目标是更简洁、符合 PostgreSQL 语法习惯的无括号形式：
WHERE "address" = decode('0x159159159526212521', 'escape')根本原因在于：jOOQ 的 condition(String, Object...) 方法返回的是 Condition 类型，为确保逻辑组合（如 .and() / .or()）中的运算符优先级正确，jOOQ 强制为其包裹括号。这是一种防御性设计，并非 bug，但在单条件场景下显得冗余。
✅ 推荐解决方案：绕过 Condition，改用字段级表达式
将原写法：
.where(condition(" 'address' = decode({0}, {1})", address, escape))替换为基于 Field 的链式构造：
Field<String> addressVal = val("0x159159159526212521");
Field<String> escapeVal = val("escape");
rdbmsJooqContext.select(
al.NAME.as("name"),
al.ADDRESS.as("address")
)
.from(al)
.where(
inline("address") // 构造字面量字段 "address"
.eq(field("decode({0}, {1})", String.class, addressVal, escapeVal))
)
.fetchInto(AddressLabelResult.class);? 关键点说明：
- inline("address") 创建一个不带引号的 SQL 字面量字段（对应 "address" 列名）；
- field("decode({0}, {1})", ...) 生成类型安全的 Field<String>，代表 decode(...) 表达式；
- .eq(...) 返回 Condition，但括号仅作用于右侧表达式内部（即 decode(...) 本身），整个谓词 address = decode(...) 不会被外层括号包裹。
⚠️ 注意事项：
- 避免直接拼接字符串（如 "address = decode('" + hex + "', 'escape')"），否则丧失 SQL 注入防护与类型推导；
- 若列名含大小写或特殊字符（如本例中双引号包裹的 "address"），建议通过 DSL.name("address") 替代 inline()，确保方言兼容性：
DSL.name("address").eq(field("decode({0}, {1})", String.class, addressVal, escapeVal)) - 此技巧适用于所有需嵌入数据库特有函数的场景（如 pgcrypto, jsonb_extract_path, tsvector @@ 等）。
总结：jOOQ 的括号机制是安全优先的设计选择；当明确处于单条件上下文且追求语义纯净时，优先选用 Field.eq(Field) 模式替代 condition()，既保持类型安全与可维护性，又输出符合预期的精简 SQL。
