如何使用JPA Criteria API和元模型查询父实体关联子实体

你遇到的重复Family实体问题，本质是因为用了普通的join而非fetch join——普通join会产生笛卡尔积结果，导致一个有N个成员的家庭被返回N次。下面是完美匹配你原生SQL逻辑的正确实现：

问题根源 #

当你调用fromFamily.join(Family_.familyMembers)时，JPA会执行类似原生SQL的LEFT JOIN，但会把每条关联记录映射为一个Family实例——也就是说，如果一个家庭有3个成员，你会得到3个完全相同的Family对象，这就是你看到的重复列表。而我们需要的是一次性加载每个Family及其关联的所有FamilyMember集合，同时避免重复的父实体。

正确的Criteria API实现 #

// 初始化EntityManager（eM）
CriteriaBuilder cB = eM.getCriteriaBuilder();
CriteriaQuery<Family> fCQ = cB.createQuery(Family.class);
Root<Family> fromFamily = fCQ.from(Family.class);

// 使用fetch join关联加载familyMembers集合，指定LEFT JOIN匹配原生SQL逻辑
fromFamily.fetch(Family_.familyMembers, JoinType.LEFT);

// 添加distinct去重，避免笛卡尔积导致的重复Family实例
fCQ.select(fromFamily).distinct(true);

TypedQuery<Family> fTQ = eM.createQuery(fCQ);
List<Family> families = fTQ.getResultList();

代码解释 #

1. fetch方法：这是实现关联加载的核心，它告诉JPA在查询Family的同时，一次性加载其关联的familyMembers集合，彻底避免了先查所有家庭再循环加载成员的N+1低效问题。
2. JoinType.LEFT：对应原生SQL的LEFT JOIN，确保即使没有成员的家庭也会被查询出来；如果只需要查询有成员的家庭，可以省略这个参数（默认是INNER JOIN）。
3. distinct(true)：必须添加这个配置，它会让JPA对查询结果去重，把笛卡尔积产生的重复Family实例合并为一个，最终每个家庭在结果列表中只出现一次，且其familyMembers集合包含所有关联的成员。

这个实现生成的SQL和你给出的原生SQL几乎一致，但JPA会自动处理结果映射，把关联的成员正确填充到对应的家庭对象中，而不是返回重复的家庭记录。

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