如何在Criteria API中实现带FETCH的多表JOIN关联查询？

嘿，这个问题我之前在项目里也踩过坑！问题出在root.fetch()返回的是Fetch接口实例，而不是Join类型，所以没法直接链式调用.join("metadata")。不过有两种简单的解决办法，帮你实现和原JPQL一致的FETCH JOIN + 后续关联：

方法一：先执行FETCH JOIN，再单独获取Join对象 #

先通过root.fetch()声明要抓取volumes关联，然后再通过root.join()获取同一个关联的Join实例，这样就能继续链式关联metadata了：

// 第一步：声明FETCH JOIN，告诉JPA要抓取volumes数据
root.fetch("volumes", JoinType.INNER);
// 第二步：获取volumes的Join对象，用于后续关联metadata
Join<Book, Volume> volumeJoin = root.join("volumes", JoinType.INNER);
// 第三步：继续关联metadata
Join<Volume, Metadata> metadataJoin = volumeJoin.join("metadata", JoinType.INNER);

方法二：使用unwrap()将Fetch转为Join #

JPA的Fetch接口支持通过unwrap()方法转换为Join类型（因为大多数JPA实现中，Fetch是Join的子类型），这样可以直接链式操作，代码更简洁：

// 直接fetch并unwrap为Join，一步到位
Join<Book, Volume> volumeJoin = root.fetch("volumes", JoinType.INNER).unwrap(Join.class);
// 继续链式关联metadata
Join<Volume, Metadata> metadataJoin = volumeJoin.join("metadata", JoinType.INNER);

修改后的完整代码片段 #

把你的代码替换成以下版本（这里用方法二的写法，你也可以换成方法一）：

query.distinct(true);

// 替换原来的链式join，改用fetch+unwrap的方式
Join<Book, Volume> volumeJoin = root.fetch("volumes", JoinType.INNER).unwrap(Join.class);
Join<Volume, Metadata> metadataJoin = volumeJoin.join("metadata", JoinType.INNER);

final Subquery<LocalDateTime> subquery = query.subquery(LocalDateTime.class);
final Root<Book> plan = subquery.from(Book.class);
subquery.where(criteriaBuilder.equal(plan.get("author"), companyId));
// 注意：这里应该用subquery的root（plan）来获取createdAt，原代码的book.get是笔误
final Expression<LocalDateTime> createdAt = plan.get("createdAt");
subquery.select(criteriaBuilder.greatest(createdAt));

predicates.add(criteriaBuilder.in(root.get("createdAt")).value(subquery));
genre.ifPresent(strings -> predicates.add(criteriaBuilder.in(metadataJoin.get("genre")).value(strings)));

return criteriaBuilder.and(predicates.toArray(new Predicate[0]));

几个关键注意点 #

• 一定要指定JoinType.INNER，和你原JPQL的INNER JOIN保持一致；
• 保留query.distinct(true)，因为FETCH JOIN可能会因为关联数据导致重复的Book实例，和原JPQL的DISTINCT对应；
• 修正了原代码里的笔误：子查询中应该用自己的Root<Book> plan来获取createdAt，而不是外部的book变量。

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