Spring Data JPA中Criteria API的Specification未生效问题排查

你的Specification被忽略的核心原因有两个：

1. Lambda表达式语法错误
   你写的(root, query, criteriaBuilder) -少了箭头的后半部分，正确的Lambda箭头是->，这个语法错误会导致无法生成有效的过滤Predicate，Spring Data JPA因此不会将过滤条件加入查询。

2. 模糊查询缺少通配符
   即使语法正确，直接使用title.toLowerCase()只会做精确匹配，无法实现模糊查询的效果，需要在前后添加%通配符。

修正后的Specification代码 #

public static Specification<Movie> hasTitleLike(String title) {
    return (root, query, criteriaBuilder) -> 
            criteriaBuilder.like(criteriaBuilder.lower(root.get("title")), "%" + title.toLowerCase() + "%");
}

额外验证点 #

• 确认调用hasTitleLike时传入的title参数非空，若需兼容空值场景，可以添加判断：

  public static Specification<Movie> hasTitleLike(String title) {
      if (title == null || title.isBlank()) {
          return (root, query, criteriaBuilder) -> criteriaBuilder.conjunction(); // 返回恒真条件，不过滤
      }
      return (root, query, criteriaBuilder) -> 
              criteriaBuilder.like(criteriaBuilder.lower(root.get("title")), "%" + title.toLowerCase() + "%");
  }
  

• 检查Movie实体的title字段映射是否正确，确保数据库列名与实体属性名匹配（你的代码中无需额外调整，Hibernate已正确映射为title列）。

修正后重新执行查询，Hibernate日志会生成包含where lower(title) like ?的SQL语句，过滤条件即可生效。

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