Spring Boot JPA findBy方法如何动态忽略值为null的查询参数？

以下是三种常用的实现方案，可根据业务场景选择：

方案1：使用@Query注解自定义JPQL（改动最小，适合固定筛选条件场景） #

直接在Repository层的查询方法上添加注解，在查询条件中判断参数为null时自动跳过该条件，无需修改Service层代码：

// Repository层代码修改为
@Query("select r from ReviewModel r where " +
       "(:branch is null or r.branch = :branch) and " +
       "(:sex is null or r.sex = :sex) and " +
       "(:ageRange is null or r.ageRange = :ageRange) and " +
       "(:purpose is null or r.purpose = :purpose)")
Page<ReviewModel> findByBranchAndSexAndAgeRangeAndPurpose(String branch, String sex, String ageRange, String purpose, Pageable pageable);

如果你的筛选参数可能传入空字符串而非null，可调整判断逻辑，例如把分支条件改为(:branch is null or :branch = '' or r.branch = :branch)即可兼容。

方案2：使用Query By Example（QBE，无需手写SQL，适合简单等值匹配场景） #

不需要修改Repository的基础定义，只需要调整Service层的查询逻辑，自动忽略null值字段：

// Service层代码修改为
// 构造查询探针，仅赋值非空的筛选参数
ReviewModel probe = new ReviewModel();
if (request.getBranch() != null) {
    probe.setBranch(request.getBranch());
}
if (request.getSex() != null) {
    probe.setSex(request.getSex());
}
if (request.getAgeRange() != null) {
    probe.setAgeRange(request.getAgeRange());
}
if (request.getPurpose() != null) {
    probe.setPurpose(request.getPurpose());
}
// 构建查询规则，默认匹配所有非null字段
Example<ReviewModel> example = Example.of(probe);
// 执行分页查询
Page<ReviewModel> reviewList = this.reviewRepository.findAll(example, pageable);

方案3：使用JPA Specifications（扩展性最强，适合后续可能新增复杂筛选条件的场景） #

如果后续需要新增范围查询、模糊查询等复杂逻辑，推荐用该方案，灵活度最高：

1. 首先让Repository接口继承JpaSpecificationExecutor

public interface ReviewRepository extends JpaRepository<ReviewModel, 主键类型>, JpaSpecificationExecutor<ReviewModel> {
    // 原有其他方法可保留
}

2. Service层构造动态查询规则：

// Service层代码修改为
Specification<ReviewModel> spec = (root, query, criteriaBuilder) -> {
    List<Predicate> predicates = new ArrayList<>();
    // 参数非空时才将对应条件加入查询
    if (request.getBranch() != null) {
        predicates.add(criteriaBuilder.equal(root.get("branch"), request.getBranch()));
    }
    if (request.getSex() != null) {
        predicates.add(criteriaBuilder.equal(root.get("sex"), request.getSex()));
    }
    if (request.getAgeRange() != null) {
        predicates.add(criteriaBuilder.equal(root.get("ageRange"), request.getAgeRange()));
    }
    if (request.getPurpose() != null) {
        predicates.add(criteriaBuilder.equal(root.get("purpose"), request.getPurpose()));
    }
    return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
};
// 执行分页查询
Page<ReviewModel> reviewList = this.reviewRepository.findAll(spec, pageable);

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