如何使用JPA Criteria API基于属性而非类根进行关联查询？

嘿，这其实是Criteria API里很常用的操作——基于已有的属性路径来链式关联，而不是每次都从新的实体根开始。我结合你给出的实体类结构，给你一步步演示怎么做：

首先明确你的实体关联链：Entity0 → Entity1 → Entity2，我们的目标是从Entity0出发，通过它的entity1属性关联到Entity1，再通过Entity1的entity2s属性关联到Entity2，全程基于属性路径，而非单独创建Entity1的根。

步骤1：准备核心API对象 #

先获取JPA操作的基础实例：

EntityManager em = ...; // 你的EntityManager实例
CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Entity0> query = cb.createQuery(Entity0.class);

步骤2：基于属性的链式关联 #

这里推荐用**JPA元模型（Metamodel）**来避免硬编码属性名（更安全，能享受到编译期检查），当然也可以用字符串参数，我两种都给你列出来：

// 获取Entity0的根实体
Root<Entity0> entity0Root = query.from(Entity0.class);

// 第一步：从Entity0的entity1属性关联到Entity1
// 元模型写法（推荐）
Join<Entity0, Entity1> entity1Join = entity0Root.join(Entity0_.entity1);
// 字符串写法（简单但无编译检查）
// Join<Entity0, Entity1> entity1Join = entity0Root.join("entity1");

// 第二步：从刚才的Entity1关联对象，基于它的entity2s属性关联到Entity2
// 元模型写法
Join<Entity1, Entity2> entity2Join = entity1Join.join(Entity1_.entity2s);
// 字符串写法
// Join<Entity1, Entity2> entity2Join = entity1Join.join("entity2s");

步骤3：添加查询条件（可选） #

比如我们要筛选出关联的Entity2的id大于5的Entity0记录：

query.where(cb.greaterThan(entity2Join.get(Entity2_.id), 5L));

// 执行查询并获取结果
List<Entity0> result = em.createQuery(query).getResultList();

额外技巧：指定关联类型 #

如果需要左连接（LEFT JOIN）而不是默认的内连接（INNER JOIN），可以在join时指定JoinType：

// 左连接Entity1
Join<Entity0, Entity1> entity1LeftJoin = entity0Root.join(Entity0_.entity1, JoinType.LEFT);
// 再左连接Entity2
Join<Entity1, Entity2> entity2LeftJoin = entity1LeftJoin.join(Entity1_.entity2s, JoinType.LEFT);

为什么这是“基于属性而非类根”？ #

因为我们没有单独创建Root<Entity1>或者Root<Entity2>，而是完全从Entity0的根出发，通过它的属性（entity1）一步步关联到下一层实体，全程依赖的是实体间的属性关联关系，而非直接从某个实体的根开始构建关联。这样做能让复杂多表查询的关联路径更清晰，避免逻辑混乱。

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