如何使用JPA Predicates查询嵌套一对多关联关系？

假设有一个包含多本书籍的图书馆系统，每本书关联多位作者（包含姓名等信息），需要用Criteria API的Predicate创建查询，找出所有拥有包含指定姓名作者的书籍的图书馆。

用户提供的初始代码框架如下：

public Predicate toPredicate(Root<Library> root, String authorName, CriteriaBuilder criteriaBuilder) {
   Predicate predicate = criteriaBuilder.and();
   Join<Library, Book> books = root.join("books");
   (...)?
   predicate = criteriaBuilder.and(predicate, (...));
   (...)?
}

用户尝试了以下写法但无法正常工作：

(...)
Join<Library, Book> books = root.join("books");
Join<Book, Author> authors = books.join("authors");
Path<Object> name = authors.get (String.valueOf(Author_.name));
Predicate subpredicate = criteriaBuilder.like(name.as(String.class), "%" + authorName + "%");
predicate = criteriaBuilder.and(predicate, (...));

问题分析 #

上述写法存在两个核心问题：

1. 错误地将元模型属性Author_.name转成字符串使用，JPA元模型类需要直接引用属性而非手动拼接字符串，否则会失去类型安全特性，还可能因属性名拼写错误导致查询失败。
2. 未处理多关联查询可能产生的重复结果问题，直接关联会因一本书对应多个作者、一个图书馆对应多本书，返回重复的图书馆记录。

正确实现示例 #

方式一：直接关联构建Predicate（需配合去重） #

这种方式逻辑直观，但查询时必须添加distinct避免重复结果：

public Predicate toPredicate(Root<Library> root, String authorName, CriteriaBuilder criteriaBuilder) {
    // 关联图书馆到书籍，再关联书籍到作者（INNER JOIN确保只返回有匹配数据的记录）
    Join<Library, Book> bookJoin = root.join("books", JoinType.INNER);
    Join<Book, Author> authorJoin = bookJoin.join("authors", JoinType.INNER);
    
    // 构建作者姓名模糊匹配的Predicate
    Predicate authorMatch = criteriaBuilder.like(
        authorJoin.get(Author_.name), 
        "%" + authorName + "%"
    );
    
    // 返回最终Predicate，后续执行查询时需调用query.distinct(true)
    return authorMatch;
}

方式二：使用子查询（避免重复结果） #

通过子查询先筛选出符合条件的书籍，再关联到图书馆，无需额外去重：

public Predicate toPredicate(Root<Library> root, String authorName, CriteriaBuilder criteriaBuilder) {
    // 创建子查询：获取包含指定作者的书籍ID集合
    Subquery<Long> bookSubquery = root.getQuery().subquery(Long.class);
    Root<Book> bookRoot = bookSubquery.from(Book.class);
    Join<Book, Author> authorSubJoin = bookRoot.join("authors");
    
    bookSubquery.select(bookRoot.get(Book_.id))
               .where(criteriaBuilder.like(authorSubJoin.get(Author_.name), "%" + authorName + "%"));
    
    // 主查询：筛选出关联书籍ID存在于子查询结果中的图书馆
    return criteriaBuilder.in(root.join("books").get(Book_.id)).value(bookSubquery);
}

关键注意事项 #

• 确保JPA元模型类（Author_、Book_、Library_）已正确生成，这些类是Criteria API类型安全查询的基础，不要手动拼接属性名。
• 若使用直接关联方式，必须在查询时添加query.distinct(true)，否则会返回重复的图书馆实体。
• 模糊匹配的通配符%可根据需求调整，比如仅匹配前缀（authorName + "%"）、后缀（"%" + authorName）或完全匹配（去掉通配符）。

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