MySQL中jOOQ正则表达式内参数绑定失败问题求助

问题根源 #

你遇到的核心问题是：jOOQ的SQL模板语法会把正则里的{1}识别为参数占位符，而非正则表达式的字面量。当你尝试用{1}指代传入的docName时，jOOQ会自动尝试解析这个占位符，但由于没有对应参数传入，导致正则语法报错；而硬编码值时，{1}被当作普通字符串处理，不会触发jOOQ的模板解析逻辑，因此查询正常。

正确解决方法 #

推荐两种安全且可行的写法，都能避免占位符冲突，同时保证参数绑定（防止SQL注入）：

方法1：用DSL.concat拼接正则表达式 #

将正则拆分为固定部分和参数部分，通过jOOQ的concat方法拼接，让参数被正确绑定：

// 传入的目标文档名称
String targetDocName = "示例文档";

// 构建查询条件：匹配原文档，或匹配"原名称 (数字)"格式的副本
Condition matchOriginalOrCopies = DOCUMENTS.NAME.eq(targetDocName)
    .or(DOCUMENTS.NAME.regexp(DSL.concat(
        DSL.val("^"),          // 正则起始标记
        DSL.val(targetDocName),// 绑定文档名称参数
        DSL.val(" \\([0-9]+\\)$") // 匹配"(数字)"结尾的副本格式
    )));

// 执行查询
Result<Record> docs = dsl.selectFrom(DOCUMENTS)
    .where(matchOriginalOrCopies)
    .fetch();

方法2：使用jOOQ SQL模板（需转义正则特殊字符） #

如果想直接写完整正则字符串，需注意Java字符串的反斜杠转义，同时用{0}作为jOOQ的参数占位符（避免和正则的{}混淆）：

String targetDocName = "示例文档";

Condition matchCondition = DOCUMENTS.NAME.eq(targetDocName)
    .or(DOCUMENTS.NAME.regexp(DSL.sql(
        "^ {0} \\((\\\\d+)\\\\)$", // Java中需用\\\\转义MySQL正则的\
        DSL.val(targetDocName)
    )));

Result<Record> docs = dsl.selectFrom(DOCUMENTS)
    .where(matchCondition)
    .fetch();

注意事项 #

• 绝对不要直接拼接字符串生成正则（比如"^" + targetDocName + " \\([0-9]+\\)$"），会存在SQL注入风险。
• 如果你的文档名称包含正则特殊字符（如.、*等），需要先对targetDocName进行正则转义，比如用Pattern.quote(targetDocName)处理后再传入。

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