JPA查询如何处理空/Null的Set<Integer>参数以返回全部数据

问题分析 #

你尝试的几种写法失败原因如下：

• 写法1：SELECT t FROM table t where :codes IS NULL OR t.code IN (:codes)
  数据库无法直接判断集合类型参数是否为NULL，当集合非空时，:codes IS NULL会被当作多列操作数处理，触发Operand should contain 1 column(s)错误。
• 写法2：SELECT t FROM table t where (:codes) IS EMPTY OR t.code IN (:codes)
  HQL的IS EMPTY语法仅适用于实体类中定义的关联集合（如@OneToMany注解的集合），不能用于方法传入的参数集合，因此启动时提示映射错误。
• 写法3：SELECT t FROM table t where size((:codes)) = 0 OR t.code IN (:codes)
  同理，HQL的size()函数仅针对实体的关联集合，无法解析参数集合，导致语法错误。

通用解决方案（无需动态构建查询） #

利用Spring Data JPA支持的SpEL表达式，在@Query中直接判断参数集合的状态，生成对应查询逻辑：

import org.springframework.data.domain.Page;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;

// 你的仓库接口
public interface TableRepository extends JpaRepository<Table, Long> {

    @Query("SELECT t FROM Table t WHERE (#{#codes == null or #codes.isEmpty()} = true) OR t.code IN (:codes)")
    Page<Table> findAll(@Param("codes") Set<Integer> codes);
}

逻辑说明：

• 当codes为null或空集合时，SpEL表达式#{#codes == null or #codes.isEmpty()}会解析为true，此时查询条件变为true OR ...，等价于无筛选条件，返回全部数据。
• 当codes包含元素时，SpEL表达式解析为false，查询条件变为false OR t.code IN (:codes)，即仅筛选符合code在集合中的数据。

这种写法无需手动拼接SQL或使用动态查询API（如Criteria API），完全通过Spring Data JPA的注解实现需求，兼容性强。

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