如何用Spring Specifications构建带分组条件的WHERE子句？

看起来你在组合复杂查询条件时，因为对Spring Specifications的链式调用优先级理解有误，导致生成的SQL分组不符合预期。我来帮你拆解问题并给出正确的写法：

问题根源 #

你的目标SQL逻辑是：

(grade > 10 AND age IS NULL) OR ( (gender = 1 AND age > 20) OR (gender != 1 AND age > 18) )

但你当前的代码生成的SQL是 grade > 10 AND (age IS NULL OR ...)，这说明你的条件组合实际上变成了 grade >10 AND (age IS NULL OR [性别年龄条件])，和目标逻辑完全相反。

为什么会这样？因为你可能误解了Specification链式调用的结合顺序：

• specA.and(specB).or(specC) 等价于 (specA AND specB) OR specC
• 而 specA.and(specB.or(specC)) 等价于 specA AND (specB OR specC)

从你的生成SQL来看，你的代码实际是第二种结构，而你需要的是第一种。

正确的条件组合方式 #

不管你是用自定义的Specification实现类，还是用Lambda方式构建，核心是要明确分组层级：

步骤1：定义基础条件 #

先把每个原子条件拆出来（这里用Lambda方式更直观，你也可以换成自定义Spec类）：

// 条件1：grade > 10
Specification<Student> gradeGt10 = (root, query, cb) -> 
    cb.greaterThan(root.get("grade"), 10);

// 条件2：age IS NULL
Specification<Student> ageIsNull = (root, query, cb) -> 
    cb.isNull(root.get("age"));

// 条件3：gender=1 AND age>20
Specification<Student> gender1AgeGt20 = (root, query, cb) -> 
    cb.and(
        cb.equal(root.get("gender"), 1),
        cb.greaterThan(root.get("age"), 20)
    );

// 条件4：gender!=1 AND age>18
Specification<Student> genderNot1AgeGt18 = (root, query, cb) -> 
    cb.and(
        cb.notEqual(root.get("gender"), 1),
        cb.greaterThan(root.get("age"), 18)
    );

步骤2：组合分组条件 #

先把性别相关的两个条件组合成一个分组：

// 分组：(gender=1 AND age>20) OR (gender!=1 AND age>18)
Specification<Student> genderAgeGroup = gender1AgeGt20.or(genderNot1AgeGt18);

步骤3：组合整体条件 #

最后把 (grade>10 AND age IS NULL) 和性别年龄分组进行OR组合：

// 最终条件：(grade>10 AND age IS NULL) OR genderAgeGroup
Specification<Student> finalSpec = gradeGt10.and(ageIsNull).or(genderAgeGroup);

如果你用自定义的Spec类（比如GradeSpec、AgeNullSpec等），写法逻辑完全一致：

Specification<Student> finalSpec = new GradeSpec()
    .and(new AgeNullSpec()) // 先组合成 (grade>10 AND age IS NULL)
    .or(new Gender1Spec().or(new Gender2Spec())); // 再和性别分组OR

验证生成的SQL #

为了确认结果，你可以开启Spring Data JPA的SQL日志，在配置文件中添加：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

这样就能看到格式化后的SQL，确保分组符合你的预期。

关键提醒 #

Spring Specifications的and()和or()方法是左结合的，链式调用的顺序直接决定了条件分组的层级。如果需要调整优先级，一定要通过嵌套调用（比如specA.and(specB.or(specC))）来明确括号位置。

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