如何在JPA Criteria API中实现单次JOIN的JOIN FETCH查询？

你遇到的问题根源在于同时使用了join()和fetch()——这两个操作会让Hibernate分别生成独立的JOIN：一个用于应用status的筛选条件，另一个用于加载关联的ProductItem数据，所以最终SQL里出现了两次product_item的JOIN。

要实现只生成一次JOIN，同时完成关联数据的抓取和条件筛选，你可以把Fetch对象转换为Join来复用，具体做法如下：

CriteriaBuilder builder = em.getCriteriaBuilder();
CriteriaQuery<Ereturn> criteria = builder.createQuery(Ereturn.class);
Root<Ereturn> er = criteria.from(Ereturn.class);

// 创建Fetch并转换为Join，同时用于抓取数据和筛选条件
Fetch<Ereturn, ProductItem> productItemFetch = er.fetch("productItems", JoinType.INNER); // 和原始JPQL的JOIN保持一致
Join<Ereturn, ProductItem> productItemJoin = productItemFetch.unwrap(Join.class);

List<Predicate> predicates = new ArrayList<>();
predicates.add(builder.equal(productItemJoin.get("status"), "RECEIVED"));

criteria.where(builder.and(predicates.toArray(new Predicate[0])));
List<Ereturn> ers = em.createQuery(criteria).getResultList();

关键说明： #

1. 我们先通过er.fetch()创建关联抓取的Fetch对象，这里使用JoinType.INNER和你原始JPQL的JOIN FETCH逻辑保持一致（你之前用的LEFT JOIN会生成左连接，和原始JPQL的内连接逻辑有差异，需要注意）。
2. 调用fetch.unwrap(Join.class)把Fetch转换为Join对象，这样这个对象既可以用来添加筛选条件，又能完成关联数据的抓取，避免生成重复的JOIN。
3. 之后用这个转换后的Join对象来构建status的相等条件，Hibernate就会生成单条JOIN语句，同时实现数据加载和条件过滤。

这样修改后，Hibernate生成的SQL就会和你原始JPQL对应的SQL一致，只包含一次product_item的JOIN。

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