JPA Specification中fetch下新增join不生效问题（Hibernate+Spring Data JPA）

规范层面 #

JPA 2.x 规范中明确FETCH JOIN的定位是仅用于关联实体的预加载，不属于查询语义中的普通关联节点，设计上没有要求FETCH节点下挂载的子关联被纳入查询条件的关联解析范围。

实现层面 #

你观察到的QueryStructure逻辑是根本原因：Hibernate 5.x 中Fetch节点和普通Join节点是完全隔离的两套存储结构：

• 所有FETCH操作生成的节点仅存入根对象的fetchs集合，渲染时由renderFetches方法单独处理，仅处理FETCH链本身的预加载逻辑，不会遍历节点下挂载的普通Join
• 所有用于查询条件的普通Join节点需要存入根对象的joins集合才会被renderJoins方法渲染
  你将C的关联挂在Fetch返回的节点上时，这个Join并没有被注册到全局的joins集合中，渲染时直接被丢弃，自然会报别名不存在的错误。

方案1：兼容Hibernate 5.x的标准写法（无需升级版本） #

显式声明普通Join用于关联C做条件，同时对同一个关联属性声明FETCH，Hibernate会自动识别为同一个关联，不会生成重复的JOIN语句，最终生成的SQL和你手写的JPQL完全一致：

(rootA, query, builder) -> {
    // 声明普通Join用于关联C做查询条件
    ListJoin<A, B> bJoin = rootA.join(A_.listOfB, JoinType.LEFT);
    ListJoin<B, C> cJoin = bJoin.join(B_.listOfC, JoinType.LEFT);
    // 对同一关联属性声明fetch，复用关联不会重复生成JOIN
    rootA.fetch(A_.listOfB, JoinType.LEFT);
    return builder.equal(cJoin.get(C_.xyz), xyz);
}

该写法完全符合JPA规范，满足需求：预加载B的关联集合，不需要预加载C的关联集合，同时可以使用C的字段做查询条件。

方案2：升级到Hibernate 6.x #

Hibernate 6重构了Criteria查询的渲染逻辑，已经修复了该问题，你原来的写法可以直接正常运行，不需要调整代码。

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