如何用Spring JPA CriteriaBuilder关联Distance表查询符合距离条件的公寓

要复现你给出的左关联查询，核心是通过CriteriaBuilder显式定义Apartment与Distance的关联条件，同时叠加距离过滤逻辑。以下是具体实现方案：

完整代码实现 #

推荐用Specification封装查询逻辑，方便后续组合其他过滤条件：

import jakarta.persistence.criteria.*;
import org.springframework.data.jpa.domain.Specification;

public class ApartmentSpecs {

    public static Specification<Apartment> withinMaxDistance(double maxDistance) {
        return (root, query, cb) -> {
            // 建立Apartment与Distance的左连接
            Join<Apartment, Distance> distanceJoin = root.join(Distance.class, JoinType.LEFT);
            
            // 设置关联条件：Distance的secondCoordinate等于Apartment的coordinate
            Predicate joinCondition = cb.equal(root.get("coordinate"), distanceJoin.get("secondCoordinate"));
            distanceJoin.on(joinCondition);
            
            // 添加距离小于等于指定值的过滤条件
            Predicate distanceFilter = cb.le(distanceJoin.get("distance"), maxDistance);
            
            // 可选：若一个公寓对应多条Distance记录，开启去重避免重复结果
            query.distinct(true);
            
            // 如需叠加其他过滤条件，直接用cb.and()组合即可，例如：
            // Predicate statusFilter = cb.equal(root.get("status"), "AVAILABLE");
            // return cb.and(distanceFilter, statusFilter);
            
            return distanceFilter;
        };
    }
}

关键细节说明 #

1. 显式关联条件：由于Apartment和Distance之间没有直接的实体关联（Apartment未维护Distance集合），必须通过join.on()手动指定关联逻辑，对应SQL中的on d.SECOND_COORDINATE=a.COORDINATE。
2. 左连接匹配：使用JoinType.LEFT严格对应原SQL的left join，确保逻辑对齐。
3. 条件组合：后续添加其他过滤条件时，只需用CriteriaBuilder的and/or方法组合多个Predicate即可，完全不需要拼接SQL字符串。
4. 去重处理：如果同一个公寓对应多条符合条件的Distance记录，添加query.distinct(true)可以避免返回重复的Apartment实例。

使用方式 #

在你的JpaRepository中集成该Specification：

public interface ApartmentRepository extends JpaRepository<Apartment, Long>, JpaSpecificationExecutor<Apartment> {
}

业务代码中调用示例：

List<Apartment> result = apartmentRepository.findAll(ApartmentSpecs.withinMaxDistance(909));

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