如何处理SQL IN语句中的空/Null列表执行异常问题？

你的问题是当传入names列表为空或Null时，以下JPQL查询无法正常执行：

@Query(value = "SELECT n FROM Names n WHERE n.name IN (:names)")
public List<NameDTO> getNames(@Param("names") List<String> names);

这是因为JPQL规范中，IN子句不允许使用空集合作为参数，部分JPA实现（比如Hibernate）遇到这种情况会直接抛出异常。下面是几种可行的解决办法：

方法一：在JPQL中添加参数判断逻辑 #

直接在查询语句里处理空/Null集合的情况，根据需求返回对应结果：

@Query(value = "SELECT n FROM Names n WHERE (:names IS NULL OR :names IS EMPTY OR n.name IN (:names))")
public List<NameDTO> getNames(@Param("names") List<String> names);

• 当names为Null或空集合时，查询会返回所有Names数据；如果需要返回空结果，可以把条件改成(:names IS NOT NULL AND :names IS NOT EMPTY AND n.name IN (:names))，此时空/Null参数会返回空列表。
• 注意部分JPA实现对集合参数的IS NULL判断支持可能有差异，建议测试验证。

方法二：调用查询前预处理参数 #

在业务层调用DAO方法前，先判断参数状态，避免执行无效查询：

// 业务层示例代码
public List<NameDTO> fetchNames(List<String> names) {
    if (names == null || names.isEmpty()) {
        return Collections.emptyList();
    }
    return nameRepository.getNames(names);
}

这种方式简单直接，适合不需要返回任何结果的场景，避免了JPA处理空参数的异常。

方法三：使用动态查询Specification #

如果需要更灵活的查询逻辑，可以借助Spring Data JPA的Specification构建动态查询：

1. 首先让Repository继承JpaSpecificationExecutor：

public interface NameRepository extends JpaRepository<Names, Long>, JpaSpecificationExecutor<NameDTO> {
}

2. 在业务层构建查询条件：

public List<NameDTO> fetchNames(List<String> names) {
    Specification<Names> spec = (root, query, cb) -> {
        if (names == null || names.isEmpty()) {
            // 返回空结果，若要返回所有数据则替换为cb.conjunction()
            return cb.disjunction();
        }
        return root.get("name").in(names);
    };
    return nameRepository.findAll(spec, NameDTO.class);
}

这种方式适合复杂的动态查询场景，能根据参数动态生成SQL。

方法四：原生SQL查询适配 #

如果使用原生SQL，可以结合数据库语法处理空集合，以MySQL为例：

@Query(value = "SELECT * FROM names WHERE (:names IS NULL OR name IN (:names))", nativeQuery = true)
public List<NameDTO> getNames(@Param("names") List<String> names);

不同数据库的语法可能有差异，需根据实际使用的数据库调整。

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