Spring JPA CriteriaBuilder生成SQL逻辑错误：AND位置不符合预期

问题原因 #

你遇到的核心问题是SQL运算符优先级导致的逻辑偏差：AND的优先级高于OR，当前生成的SQL等价于：

select *
from test_entity testentity0_ 
where
    (testentity0_.cost in (5.0) or testentity0_.cost in (5.0))
    and testentity0_.name like ?

这和你期望的逻辑完全不符，你需要的是将cost in (5.0)和name like ?作为一个整体，成为OR的第二个分支。

修正后的CriteriaBuilder代码 #

虽然原代码逻辑写法看似正确，但部分JPA实现可能在SQL渲染时没有正确为AND组合添加整体括号。通过显式拆分Predicate的方式，可以确保逻辑结构清晰，让JPA生成符合预期的SQL：

CriteriaBuilder criteriaBuilder = entityManager.getCriteriaBuilder();
CriteriaQuery<TestEntity> criteriaQuery = criteriaBuilder.createQuery(TestEntity.class);
Root<TestEntity> itemRoot = criteriaQuery.from(TestEntity.class);
criteriaQuery.select(itemRoot);

// 构建第一个IN条件
javax.persistence.criteria.CriteriaBuilder.In inClause = criteriaBuilder.in(itemRoot.get("cost"));
inClause.value(criteriaBuilder.literal(5.0d));

// 构建第二个IN条件
javax.persistence.criteria.CriteriaBuilder.In inClause2 = criteriaBuilder.in(itemRoot.get("cost"));
inClause2.value(criteriaBuilder.literal(5.0d));

// 显式构建AND组合的Predicate，确保两个条件作为整体
Predicate andPredicate = criteriaBuilder.and(
    inClause2,
    criteriaBuilder.like(itemRoot.get("name"), "%name%")
);

// 构建OR条件，将AND组合作为第二个分支
Predicate pred = criteriaBuilder.or(inClause, andPredicate);

criteriaQuery.where(pred);
TypedQuery<TestEntity> typedQuery = entityManager.createQuery(criteriaQuery);
List<TestEntity> list = typedQuery.getResultList();

生成的目标SQL #

调整后，JPA会生成符合你期望的SQL：

select *
from test_entity testentity0_ 
where
    testentity0_.cost in (
        5.0
    ) 
    or (
        testentity0_.cost in (
            5.0
        )
        and (
            testentity0_.name like ?
        )
    ) 

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