Spring Boot 3中CriteriaBuilder调用contains生成异常SQL求助

你遇到的where 1!=1是因为无效的谓词表达式导致的：当你通过cb.disjunction()创建逻辑或谓词后，添加的contains函数表达式无法被JPA正确解析（比如数据库不支持该函数、参数异常），最终这个谓词没有任何有效子条件，JPA会将其转换为等价的1!=1（恒假条件），因此查询无结果。

核心问题点 #

1. 数据库兼容性问题：JPA的CriteriaBuilder.function()调用的是数据库原生函数，但不同数据库对contains的支持差异极大：
   • MySQL没有内置的contains函数（需用全文索引的MATCH AGAINST，或通用的LIKE）；
   • SQL Server的CONTAINS需要先对字段创建全文索引才能使用；
   • 若数据库不支持该函数，JPA会直接忽略这个表达式，导致disjunction无有效条件。
2. 不必要的disjunction使用：你仅添加了一个查询条件，无需用disjunction（逻辑或），直接返回单个条件即可。
3. 缺失参数校验：若search.adr()或adr为空字符串，也会导致条件无效。

解决方案 #

方案1：用JPA标准LIKE实现模糊匹配（通用兼容所有数据库）

这是最稳妥的方式，无需依赖数据库特定函数：

Specification方式修正

Specification<School> specification = (Root<School> root, CriteriaQuery<?> cq, CriteriaBuilder cb) -> {
    // 先校验参数非空
    if (search.adr() == null || search.adr().isEmpty()) {
        return cb.conjunction(); // 返回恒真条件，查询所有数据
    }
    // 构造模糊匹配模式，忽略大小写
    String adrPattern = "%" + search.adr() + "%";
    return cb.like(cb.lower(root.get("adr")), cb.lower(cb.literal(adrPattern)));
};
return findAll(specification, page);

Criteria方式修正

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<School> cq = cb.createQuery(School.class);
Root<School> rootSchool = cq.from(School.class);

Predicate p = cb.conjunction();
if (adr != null && !adr.isEmpty()) {
    String adrPattern = "%" + adr + "%";
    p.getExpressions().add(cb.like(cb.lower(rootSchool.get("adr")), cb.lower(cb.literal(adrPattern))));
}
cq.where(p);

List<School> schools = entityManager.createQuery(cq).getResultList();

方案2：使用数据库原生contains函数（针对特定数据库）

如果你的数据库支持contains（比如SQL Server），需先确保adr字段已创建全文索引，再修正函数调用：

SQL Server下的Specification示例

Specification<School> specification = (Root<School> root, CriteriaQuery<?> cq, CriteriaBuilder cb) -> {
    if (search.adr() == null || search.adr().isEmpty()) {
        return cb.conjunction();
    }
    // 调用SQL Server的CONTAINS函数
    return cb.function("CONTAINS", Boolean.class, root.get("adr"), cb.literal(search.adr()));
};
return findAll(specification, page);

关键注意事项 #

• 优先使用JPA标准API（如LIKE），避免数据库绑定；
• 必须添加参数非空校验，防止生成无效谓词；
• 若使用数据库原生函数，需确认函数名称、参数顺序与数据库语法完全匹配，同时满足函数的前置要求（如全文索引）。

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