JPA Query By Example为何会对空值生成WHERE子句？

核心原因 #

你遇到的问题根源在于**@Formula标注的计算字段在JPA Query By Example中的特殊处理逻辑**：
虽然你显式把yearPublished设为null，但它是通过数据库函数生成的虚拟字段（而非物理列），Spring Data JPA的Example查询在解析这类字段时，会将Integer类型的null值错误解析为默认值0，从而强制生成(Year(comicdetai0_.coverdate)) = 0的条件。

monthPublished看似正常，只是因为你未在未传值的场景下触发同样的解析逻辑，本质上它存在同样的潜在问题。

解决方案 #

方案1：调整ExampleMatcher，默认忽略计算字段

通过withIgnorePaths默认排除yearPublished和monthPublished，仅在需要筛选时才将其加入匹配规则：

final ComicDetail detail = new ComicDetail();

// 引用类型默认值为null，无需显式设置
// detail.setCoverDate(null);
// detail.setYearPublished(null);
// detail.setMonthPublished(null);

ExampleMatcher matcher = ExampleMatcher.matching()
    .withIgnorePaths("yearPublished", "monthPublished"); // 默认忽略计算字段

if (coverYear != null) {
  log.debug("Setting cover year filter: {}", coverYear);
  detail.setYearPublished(coverYear);
  matcher = matcher.withIncludePaths("yearPublished")
                   .withMatcher("yearPublished", ExampleMatcher.GenericPropertyMatchers.exact());
}

if (coverMonth != null) {
  log.debug("Setting cover month filter: {}", coverMonth);
  detail.setMonthPublished(coverMonth);
  matcher = matcher.withIncludePaths("monthPublished")
                   .withMatcher("monthPublished", ExampleMatcher.GenericPropertyMatchers.exact());
}

this.comicDetailRepository.findAll(Example.of(detail, matcher));

方案2：改用JPA Specification实现筛选（更推荐）

对于包含计算字段的复杂筛选，Example的灵活性不足，直接用Criteria API构建Specification会更可靠：

1. 让Repository继承JpaSpecificationExecutor：

public interface ComicDetailRepository extends JpaRepository<ComicDetail, Long>, JpaSpecificationExecutor<ComicDetail> {
}

2. 在业务层构建查询条件：

Specification<ComicDetail> spec = (root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    if (coverYear != null) {
        // 直接调用数据库YEAR函数
        predicates.add(cb.equal(cb.function("YEAR", Integer.class, root.get("coverDate")), coverYear));
    }
    if (coverMonth != null) {
        // 直接调用数据库MONTH函数
        predicates.add(cb.equal(cb.function("MONTH", Integer.class, root.get("coverDate")), coverMonth));
    }
    return cb.and(predicates.toArray(new Predicate[0]));
};

// 分页查询
this.comicDetailRepository.findAll(spec, PageRequest.of(pageNum, pageSize));

这种方式完全绕开了Example对计算字段的解析问题，同时支持更复杂的组合筛选逻辑。

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