JPQL查询中枚举类型的全量筛选实现方案咨询

针对你遇到的枚举参数无法通过传空值实现全量筛选、当前存在代码冗余的问题，这里提供几种实用的优雅解决方式：

方案一：修改JPQL，增加参数空值判断 #

直接在原JPQL的WHERE条件中加入对:cuisine的空值判断逻辑，让同一个方法同时支持指定枚举值筛选和全量查询：

@Query("SELECT rest FROM Restaurant rest LEFT JOIN rest.votes vote " +
        "WHERE (rest.name LIKE concat('%', :searchQuery, '%') OR rest.address LIKE concat('%', :searchQuery, '%')) " +
        "AND (:cuisine IS NULL OR rest.cuisine = :cuisine) " +
        "GROUP BY rest.id ORDER BY COUNT(vote.id) DESC")
Page<Restaurant> findAllSortedByRating(@Param("searchQuery") String searchQuery, 
                                       @Param("cuisine") СuisineType cuisine, 
                                       Pageable pageable);

使用规则：

• 筛选指定菜系：传入对应的СuisineType枚举值
• 查询全量数据：传入null作为cuisine参数

方案二：使用Spring Data JPA的Specification动态构建查询 #

如果后续筛选条件可能扩展，用Specification可以灵活动态拼接查询逻辑，彻底避免硬编码JPQL的冗余问题：

1. 先定义Specification逻辑：

public static Specification<Restaurant> filterBySearchQueryAndCuisine(String searchQuery, СuisineType cuisine) {
    return (root, query, criteriaBuilder) -> {
        List<Predicate> predicates = new ArrayList<>();
        
        // 处理搜索关键词条件
        if (searchQuery != null && !searchQuery.isEmpty()) {
            String likePattern = "%" + searchQuery + "%";
            Predicate nameLike = criteriaBuilder.like(root.get("name"), likePattern);
            Predicate addressLike = criteriaBuilder.like(root.get("address"), likePattern);
            predicates.add(criteriaBuilder.or(nameLike, addressLike));
        }
        
        // 处理菜系枚举条件
        if (cuisine != null) {
            predicates.add(criteriaBuilder.equal(root.get("cuisine"), cuisine));
        }
        
        // 构建分组与排序
        query.groupBy(root.get("id"));
        query.orderBy(criteriaBuilder.desc(criteriaBuilder.count(root.join("votes", JoinType.LEFT).get("id"))));
        
        return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
    };
}

2. 让Repository继承JpaSpecificationExecutor：

public interface RestaurantRepository extends JpaRepository<Restaurant, Long>, JpaSpecificationExecutor<Restaurant> {
}

3. 调用查询：

Page<Restaurant> result = restaurantRepository.findAll(
    filterBySearchQueryAndCuisine(searchQuery, cuisine),
    pageable
);

方案三：QueryDSL动态查询（适合复杂场景） #

如果项目已引入QueryDSL，可以用它构建类型安全的动态查询，代码更简洁且易于维护，同样能消除冗余代码。

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