JPA继承搭配EntityGraph查询时关联实体重复查询的解决方法

• 重复JOIN的根源是手动关联过滤和EntityGraph加载关联两个操作被Hibernate分别处理，各自生成了JOIN语句。
• 你的过滤条件仅作用于手动JOIN的关联，而EntityGraph触发的第二次JOIN会加载所有关联的Country，导致最终实体仍包含所有国家，过滤逻辑失效。

方案1：用fetch替代join，同时实现过滤与关联加载 #

直接在CriteriaQuery中使用fetch关联Country，既完成过滤，又确保关联数据被加载，无需额外使用EntityGraph。这样只会生成一次JOIN，过滤条件也能正确作用于关联数据：

CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
CriteriaQuery<ChildA> criteriaQuery = criteriaBuilder.createQuery(ChildA.class);
Root<ChildA> root = criteriaQuery.from(ChildA.class);

List<Predicate> predicates = new ArrayList<>();
// 使用fetch替代join，同时加载关联并用于过滤
final Fetch<ChildA, Country> fetch = root.fetch(ChildA_.COUNTRIES, JoinType.INNER);
predicates.add(criteriaBuilder.equal(fetch.get(Country_.CODE), "USA"));

criteriaQuery.where(predicates.toArray(Predicate[]::new));
// 无需设置EntityGraph
TypedQuery<ChildA> finalQuery = entityManager.createQuery(criteriaQuery);

List<ChildA> result = finalQuery.getResultList();

说明：这里用INNER JOIN替代LEFT JOIN，因为你需要过滤出关联了USA的ChildA，INNER JOIN更符合业务逻辑，也避免了不必要的空值处理。如果确实需要保留没有关联国家的ChildA，可以继续用LEFT JOIN，但要调整过滤条件为criteriaBuilder.or(criteriaBuilder.isNull(fetch.get(Country_.CODE)), criteriaBuilder.equal(fetch.get(Country_.CODE), "USA"))。

方案2：保留EntityGraph，改用子查询过滤 #

如果必须使用EntityGraph来控制关联加载，可以通过子查询筛选出符合条件的ChildA ID，再基于这些ID查询实体并加载关联，避免直接JOIN导致的重复关联：

// 1. 子查询：获取关联了USA的ChildA ID
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<UUID> subQuery = cb.createQuery(UUID.class);
Root<ChildA> subRoot = subQuery.from(ChildA.class);
Join<ChildA, Country> subJoin = subRoot.join(ChildA_.COUNTRIES);
subQuery.select(subRoot.get(Parent_.ID))
        .where(cb.equal(subJoin.get(Country_.CODE), "USA"));

// 2. 主查询：基于子查询结果获取ChildA，并通过EntityGraph加载countries
EntityGraph<ChildA> entityGraph = entityManager.createEntityGraph(ChildA.class);
entityGraph.addAttributeNodes(Parent_.COUNTRIES);

CriteriaQuery<ChildA> mainQuery = cb.createQuery(ChildA.class);
Root<ChildA> mainRoot = mainQuery.from(ChildA.class);
mainQuery.select(mainRoot)
        .where(mainRoot.get(Parent_.ID).in(subQuery));

TypedQuery<ChildA> finalQuery = entityManager.createQuery(mainQuery)
        .setHint(EntityGraphPersistence.LOAD_GRAPH, entityGraph);

List<ChildA> result = finalQuery.getResultList();

说明：子查询先筛选出符合条件的ChildA主键，主查询根据主键加载实体，EntityGraph负责加载关联的Country，此时只会生成一次关联JOIN，且返回的ChildA仅包含符合条件的关联国家。

方案3：调整EntityGraph为FETCH_GRAPH（辅助优化） #

将LOAD_GRAPH改为FETCH_GRAPH，它只会加载EntityGraph中指定的关联，不会额外加载其他关联。但需要配合子查询使用，单独使用可能无法完全解决重复JOIN问题：

TypedQuery<ChildA> finalQuery = entityManager
    .createQuery(criteriaQuery)
    .setHint(EntityGraphPersistence.FETCH_GRAPH, entityGraph);

• 避免同时使用手动JOIN过滤和EntityGraph加载同一关联，这是导致重复JOIN的核心原因。
• 如果你需要过滤关联数据并同时加载该关联，优先使用fetch方法，它能在一个步骤中完成两个操作。
• 当使用JOIN过滤关联数据时，要注意JOIN类型对结果的影响：INNER JOIN会过滤掉无匹配关联的实体，LEFT JOIN需要配合相应的空值处理逻辑。

内容的提问来源于stack exchange，提问作者João Pedro Schmitt