如何用SpringBoot JPA Repository实现多重复条件OR查询

要一次性获取符合多个(column1 >= X AND column1 <= Y) OR条件的数据，无需多次执行单区间查询，你可以采用以下几种实用方案：

方案1：@Query注解手写JPQL #

直接在Repository接口中编写JPQL查询，通过传递区间集合批量处理OR逻辑。

首先定义一个极简的区间DTO封装起止值：

public class Range {
    private final Long start;
    private final Long end;

    public Range(Long start, Long end) {
        this.start = start;
        this.end = end;
    }

    // 仅保留必要的getter方法
    public Long getStart() { return start; }
    public Long getEnd() { return end; }
}

然后在Repository中添加查询方法：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import java.util.List;

public interface YourEntityRepo extends JpaRepository<YourEntity, Long> {

    @Query("SELECT e FROM YourEntity e WHERE EXISTS (" +
           "   SELECT 1 FROM :ranges r " +
           "   WHERE e.column1 >= r.start AND e.column1 <= r.end" +
           ")")
    List<YourEntity> findByColumn1InRanges(List<Range> ranges);
}

若需要原生SQL优化，或JPA版本不支持自定义DTO集合绑定，可改用原生查询（以下为PostgreSQL示例，其他数据库需调整集合处理语法）：

@Query(value = "SELECT * FROM your_table e WHERE EXISTS (" +
               "   SELECT 1 FROM unnest(:ranges) r(start bigint, end bigint) " +
               "   WHERE e.column1 >= r.start AND e.column1 <= r.end" +
               ")", nativeQuery = true)
List<YourEntity> findByColumn1InRangesNative(List<Range> ranges);

方案2：JPA Specification动态构建查询 #

如果需要灵活组合其他查询条件，或区间数量完全动态，用Specification更适配。

先编写一个Specification工具类：

import org.springframework.data.jpa.domain.Specification;
import javax.persistence.criteria.*;
import java.util.ArrayList;
import java.util.List;

public class YourEntitySpecs {

    public static Specification<YourEntity> column1InRanges(List<Range> ranges) {
        return (Root<YourEntity> root, CriteriaQuery<?> query, CriteriaBuilder cb) -> {
            if (ranges == null || ranges.isEmpty()) {
                return cb.conjunction(); // 返回空条件，查询全量数据
            }

            List<Predicate> predicates = new ArrayList<>();
            for (Range range : ranges) {
                predicates.add(cb.between(root.get("column1"), range.getStart(), range.getEnd()));
            }

            // 将所有区间条件用OR连接
            return cb.or(predicates.toArray(new Predicate[0]));
        };
    }
}

让Repository继承JpaSpecificationExecutor接口：

public interface YourEntityRepo extends JpaRepository<YourEntity, Long>, JpaSpecificationExecutor<YourEntity> {
}

调用示例：

List<Range> targetRanges = List.of(new Range(10L, 20L), new Range(30L, 40L));
List<YourEntity> result = yourEntityRepo.findAll(YourEntitySpecs.column1InRanges(targetRanges));

方案3：Querydsl简化动态查询 #

若项目已引入Querydsl，可通过更简洁的API构建查询：

先确保Maven依赖（Gradle可对应调整）：

<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-apt</artifactId>
    <scope>provided</scope>
</dependency>

Repository继承QuerydslPredicateExecutor：

public interface YourEntityRepo extends JpaRepository<YourEntity, Long>, QuerydslPredicateExecutor<YourEntity> {
}

构建并执行查询：

QYourEntity qEntity = QYourEntity.yourEntity;
List<Range> ranges = List.of(new Range(10L, 20L), new Range(30L, 40L));

BooleanExpression predicate = null;
for (Range range : ranges) {
    BooleanExpression rangeExpr = qEntity.column1.between(range.getStart(), range.getEnd());
    predicate = (predicate == null) ? rangeExpr : predicate.or(rangeExpr);
}

List<YourEntity> result = yourEntityRepo.findAll(predicate);

注意事项 #

• 确保column1字段已添加合适索引，避免多区间查询触发全表扫描。
• 使用原生SQL时，必须根据数据库类型调整集合参数处理逻辑，禁止硬拼SQL字符串，防止注入风险。
• 若区间数量极大，建议分批查询或优化数据库策略，避免内存溢出。

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