JPA Specification实现非直接关联远端实体字段条件查询方法

前置检查：实体关联配置 #

首先确保三个实体的JPA关联注解配置正确，不需要额外修改数据库结构：

• Entity类配置与Relation的ManyToOne关联

@Entity
public class Entity {
    // 主键、自身业务字段省略
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "relation_id") // 指向Relation表主键的外键字段名
    private Relation relation;
}

• Relation类配置与DistantRelation的ManyToMany关联

@Entity
public class Relation {
    // 主键、自身业务字段省略
    @ManyToMany(fetch = FetchType.LAZY)
    @JoinTable(
        name = "rel_relation_distant", // 两表多对多中间表名
        joinColumns = @JoinColumn(name = "relation_id"),
        inverseJoinColumns = @JoinColumn(name = "distant_relation_id")
    )
    private Set<DistantRelation> distantRelations = new HashSet<>();
}

• DistantRelation类正常声明需要作为过滤条件的字段即可，不需要额外配置关联。

编写Specification逻辑 #

核心逻辑是通过Criteria API的多级Join串联关联路径，直接在最远的关联表字段上添加谓词条件，JPA会自动生成带关联的SQL语句。
示例：过滤DistantRelation表中status字段值为1的所有Entity记录

public Specification<Entity> buildDistantFilter() {
    return (root, query, cb) -> {
        // 关联第一层：Entity -> Relation，使用内连接
        Join<Entity, Relation> relationJoin = root.join("relation", JoinType.INNER);
        // 关联第二层：Relation -> DistantRelation，ManyToMany场景下会自动关联中间表
        Join<Relation, DistantRelation> distantJoin = relationJoin.join("distantRelations", JoinType.INNER);
        
        // 避免多对多关联导致的结果重复
        query.distinct(true);
        
        // 添加过滤条件，这里以等值匹配为例，可根据需求替换为like、between、in等其他条件
        return cb.equal(distantJoin.get("status"), 1);
    };
}

注意事项 #

• join方法传入的属性名必须和实体类中声明的关联属性名完全一致，否则会抛出属性找不到的异常。
• 如果需要保留无关联数据的Entity记录，将JoinType.INNER替换为JoinType.LEFT即可，对应SQL的左外连接逻辑。
• 多条件过滤时，可通过cb.and()、cb.or()组合多个谓词，写法和单表查询完全一致。
• 如果需要对关联表做聚合过滤（比如统计符合条件的DistantRelation数量大于N），可以在join后使用cb.count()等聚合函数，配合groupBy、having子句实现。

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