Hibernate 6.2 虽支持 CTE，但当前版本（截至 6.2.x）在 HQL 中直接 JOIN 多个 CTE 会触发 IllegalArgumentException；根本原因在于解析器错误地将 CTE 别名当作实体引用处理。本文详解问题成因、可用替代方案（含 CROSS JOIN 和嵌套 CTE），并提供可落地的实践建议。
hibernate 6.2 虽支持 cte，但当前版本（截至 6.2.x）在 hql 中直接 join 多个 cte 会触发 `illegalargumentexception`；根本原因在于解析器错误地将 cte 别名当作实体引用处理。本文详解问题成因、可用替代方案（含 cross join 和嵌套 cte），并提供可落地的实践建议。
Hibernate 6.2 正式引入了对 SQL 公共表表达式（CTE）的原生 HQL 支持，极大增强了复杂查询的可读性与复用性。然而，当尝试在单条 HQL 中定义多个 CTE 并通过 JOIN 关联它们时（如 max_cities JOIN min_cities ON ...），尽管语法完全符合标准 SQL（MySQL/PostgreSQL 均支持），Hibernate 却抛出如下异常：
Caused by: java.lang.IllegalArgumentException: Could not resolve entity reference: min_cities
该异常源于 Hibernate 查询解析器内部的一个逻辑缺陷：在处理 JOIN 子句中的标识符（如 min_cities）时，ExpectingEntityJoinDelegate#consumeIdentifier 方法强制调用 resolveHqlEntityReference() 尝试将其解析为 JPA 实体，而未优先检查当前作用域内是否已存在同名 CTE。即使后续代码中已预留了 findCteStatement(...) 的兜底逻辑，但由于 resolveHqlEntityReference() 在遇到非实体名时直接抛异常（而非返回 null），导致 CTE 联结路径永远无法进入正确分支。
✅ 当前可行的绕过方案
-
使用隐式 CROSS JOIN + WHERE 条件（推荐）
这是目前最稳定、兼容性最好的方式。Hibernate 正确识别 CTE 别名在 FROM 子句中的出现，并允许逗号分隔的隐式联结：
TypedQuery<Integer> query = em.createQuery(
"""
WITH max_cities AS (
SELECT c.id FROM City c ORDER BY c.population DESC LIMIT 20
),
min_cities AS (
SELECT c.id FROM City c ORDER BY c.population ASC LIMIT 20
)
SELECT m1.id
FROM max_cities m1, min_cities m2
WHERE m1.id = m2.id
""",
Integer.class
);⚠️ 注意：确保 SELECT 子句中引用的字段来自 CTE 定义的投影列（如本例中 CTE 显式选了 c.id），且 HQL 中的属性名需与 CTE 内部别名一致（避免使用 c.id AS id 后又写 m1.id —— 某些方言可能要求显式别名匹配）。
-
合并为单个 CTE（适用于逻辑可融合场景）
若目标是求交集（如本例“人口最多与最少的前 20 城市重合”），可改用窗口函数在一个 CTE 中完成：
"""
WITH ranked_cities AS (
SELECT
id,
ROW_NUMBER() OVER (ORDER BY population DESC) AS rn_desc,
ROW_NUMBER() OVER (ORDER BY population ASC) AS rn_asc
FROM City
)
SELECT id
FROM ranked_cities
WHERE rn_desc <= 20 AND rn_asc <= 20
"""-
退回到原生 SQL（终极可控方案）
当业务逻辑复杂且必须强依赖多 CTE 显式 JOIN 时，createNativeQuery() 可完全规避 HQL 解析限制：
List<Integer> result = em.createNativeQuery(
"""
WITH max_cities AS (
SELECT id FROM city ORDER BY population DESC LIMIT 20
),
min_cities AS (
SELECT id FROM city ORDER BY population ASC LIMIT 20
)
SELECT m1.id
FROM max_cities m1
INNER JOIN min_cities m2 ON m1.id = m2.id
""", Integer.class)
.getResultList();✅ 优势：100% 遵循数据库原生语法；✅ 劣势：失去 HQL 的类型安全与移植性，需手动处理方言差异（如分页关键字、引号规则）。
? 总结与建议
- 此问题属于 Hibernate 6.2.x 的已知解析器缺陷（HHH-17789 类似），官方尚未在 6.3+ 版本中修复，不建议在生产环境依赖多 CTE 显式 JOIN；
- 优先采用 CROSS JOIN + WHERE 模式，语义清晰且零风险；
- 对性能敏感场景，务必结合 EXPLAIN 分析执行计划——多数数据库会对上述 CTE 组合生成高效物化临时结果，无需过度担忧；
- 关注 Hibernate ORM GitHub Issues 中关于 SqmCteJoin 和 CTE join support 的进展，未来版本有望彻底解决该限制。
