Spring Data Specifications：多DocumentIdentifier的IN条件连表查询问题

原有正确实现（单值条件） #

已实现基于Spring Data Specifications的两表关联查询，通过单个documentIdentifier作为条件：

static Specification<Copy> withDocumentIdentifier(String documentIdentifier) {
    return (root, query, criteriaBuilder) -> criteriaBuilder.equal(
            root.join(Copy_.documents).get(Document_.documentIdentifier),
            documentIdentifier
    );
}

改造尝试与报错 #

需要改造为支持传入documentIdentifier列表的IN查询，尝试写法如下：

static Specification<Copy> withDocumentIdentifiers(List<String> documentIdentifiers) {
    return (root, query, criteriaBuilder) -> {
        List<Predicate> predicates = new ArrayList<>();
        SetJoin<Copy, Document> copiesWithDocuments = root.join(Copy_.documents);
        predicates.add(copiesWithDocuments.in(documentIdentifiers)); // 错误位置

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

运行时触发错误：

{"timestamp":"08-06-2023 01:06:41","status":"BAD_REQUEST","message":"Error occurred","errors":["class org.hibernate.type.internal.NamedBasicTypeImpl cannot be cast to class org.hibernate.metamodel.mapping.EntityValuedModelPart (org.hibernate.type.internal.NamedBasicTypeImpl and org.hibernate.metamodel.mapping.EntityValuedModelPart are in unnamed module of loader 'app')"]}

错误原因 #

错误在于直接对关联实体对象（SetJoin<Copy, Document>）调用in方法，IN操作应当针对实体的具体属性（此处为documentIdentifier），而非实体本身。这种写法导致Hibernate尝试将基础数据类型转换为实体映射组件，触发类型转换异常。

正确实现方式 #

方式1：简化版实现 #

直接针对关联实体的documentIdentifier属性构建IN条件：

static Specification<Copy> withDocumentIdentifiers(List<String> documentIdentifiers) {
    return (root, query, criteriaBuilder) -> 
        root.join(Copy_.documents)
            .get(Document_.documentIdentifier)
            .in(documentIdentifiers);
}

方式2：保留Predicate列表的实现（适配原有代码结构） #

如果需要保留多条件组合的结构，正确写法如下：

static Specification<Copy> withDocumentIdentifiers(List<String> documentIdentifiers) {
    return (root, query, criteriaBuilder) -> {
        List<Predicate> predicates = new ArrayList<>();
        SetJoin<Copy, Document> copiesWithDocuments = root.join(Copy_.documents);
        // 针对documentIdentifier属性调用in方法
        predicates.add(copiesWithDocuments.get(Document_.documentIdentifier).in(documentIdentifiers));

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

补充说明 #

• 若关联关系可能为空，建议使用root.join(Copy_.documents, JoinType.LEFT)避免过滤掉无关联Document的Copy记录
• 若需要去重（避免因关联多条Document导致Copy记录重复），可添加query.distinct(true)

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