本文详解如何在 querydsl-sql（非 jpa）中绕过原生不支持 `update ... join` 的限制，通过 `addflag` 与 `stringtemplate` 注入自定义 sql 片段，安全高效地生成带表连接的更新语句，避免性能灾难性的子查询。
QueryDSL-SQL 的 SqlUpdateClause 确实不原生支持多表 JOIN 语法用于 UPDATE 操作——其设计聚焦于单表更新，where 子句中仅允许基于子查询或简单条件过滤。当业务需依据关联表（如 MY_TABLE_2）字段更新主表（MY_TABLE）时，若强行使用 .in(dsl.select(...)) 构建子查询，极易引发全表扫描与嵌套执行计划退化，导致耗时从秒级飙升至小时级（如问题中 10 秒 vs 超 1 小时的对比）。
所幸，QueryDSL 提供了底层扩展机制：addFlag() 配合 QueryFlag.Position.START_OVERRIDE 可在 SQL 生成的起始位置注入自定义模板，从而“接管”UPDATE 关键字后的主体结构。核心技巧在于用 Expressions.stringTemplate 构造带 JOIN 的前缀，并添加占位符 # 触发 QueryDSL 自动忽略默认表名（否则会重复拼接 table1，导致语法错误）。
以下为推荐实现方案：
dsl.update(table1)
.set(my_field, "SOME_VALUE")
.addFlag(
QueryFlag.Position.START_OVERRIDE,
Expressions.stringTemplate(
"update {0} join {1} on {2} = {3} #",
table1, table2,
table1.fieldWithFkToTable2,
table2.id
)
)
.where(
table2.otherField.eq(12324556789),
table2.otherField.like("%something%")
);✅ 生成 SQL 效果（MySQL 兼容）：
update MY_TABLE join MY_TABLE_2 on MY_TABLE.FIELD_WITH_FK = MY_TABLE_2.ID # set MY_FIELD = 'SOME_VALUE' where MY_TABLE_2.OTHER_FIELD = 12324556789 and MY_TABLE_2.OTHER_FIELD like '%something%'
⚠️ 关键注意事项：
- # 符号是必需的“占位符”——它告诉 QueryDSL：此处之后的默认表名（即 table1）应被跳过，否则将生成 update MY_TABLE join ... # MY_TABLE 这类非法语法；
- where 条件中所有字段必须显式指定所属表变量（如 table2.otherField），不可直接写 otherField，否则 QueryDSL 无法解析上下文；
- 此方案依赖数据库对 UPDATE ... JOIN 的支持（MySQL 完全支持；PostgreSQL 需用 UPDATE ... FROM 语法，此时模板需调整）；
- 生产环境务必验证生成 SQL 的执行计划（EXPLAIN），确保 JOIN 字段已建立索引（尤其是 table2.id 和 table2.otherField）；
- 若需兼容多种数据库，建议封装为工具方法，并按 SQLTemplates 类型（如 MySQLTemplates/PostgreSQLTemplates）动态切换模板字符串。
该方案虽属“扩展性规避”，但稳定可靠、零侵入、无反射风险，已成为 QueryDSL-SQL 多表更新的事实标准实践。它用最小改动换取数量级性能提升，真正践行了“以可控复杂度解决真实瓶颈”的工程哲学。
