使用Hibernate/JpaRepository时原生查询空List引发异常求助

这个问题我碰到过好多次，PostgreSQL对空的IN()子句确实会直接抛出语法错误，咱们来梳理几个实用的解决思路：

1. 在Repository层提前拦截空列表（最直接） #

既然空列表的场景很常见，咱们可以在Repository里加一个默认方法，先判断列表是否为空，为空直接返回空集合，不用走数据库查询：

// 新增默认方法做前置判断
default List<History> getHistoriesByProjectsIn(List<Long> projects) {
    if (projects == null || projects.isEmpty()) {
        return Collections.emptyList();
    }
    // 调用原来的查询方法
    return getHistoriesByProjectsInQuery(projects);
}

// 把原来的方法改名，作为实际执行查询的方法
@Query(value="select * from history h where h.project_id in :projects", nativeQuery=true)
List<History> getHistoriesByProjectsInQuery(@Param("projects")List<Long> projects);

这种方式的好处是简单高效，避免了无效的数据库请求，完全贴合你空列表返回空结果的业务场景。

2. 修改原生SQL，兼容空列表 #

如果不想拆分方法，可以直接在SQL里处理空列表的情况，让条件在列表为空时自动不生效（或者返回空结果）。针对PostgreSQL，可以用array_length函数判断数组长度：

@Query(value="select * from history h where (array_length(:projects, 1) > 0 and h.project_id in :projects)", nativeQuery=true)
List<History> getHistoriesByProjectsIn(@Param("projects")List<Long> projects);

当传入空列表时，array_length(:projects, 1)会返回0，整个条件变为false，查询结果就是空集合，完美避免语法错误。

如果你业务上空列表需要返回所有数据，只需调整条件：

@Query(value="select * from history h where (array_length(:projects, 1) = 0 or h.project_id in :projects)", nativeQuery=true)
List<History> getHistoriesByProjectsIn(@Param("projects")List<Long> projects);

3. 使用JPA Criteria API动态构建查询 #

如果你的查询以后可能有更多动态条件，用Criteria API会更灵活，它会自动处理空列表的情况：

// 在Service层或者自定义Repository实现里写
public List<History> getHistoriesByProjectsIn(List<Long> projects) {
    Specification<History> spec = (root, query, cb) -> {
        if (projects == null || projects.isEmpty()) {
            // 返回一个永远为false的条件，得到空结果
            return cb.disjunction();
            // 如果需要返回所有数据，就返回cb.conjunction();
        }
        return root.get("projectId").in(projects);
    };
    return historyRepository.findAll(spec);
}

这种方式不需要写原生SQL，JPA会根据参数自动生成合法的SQL，兼容性更好。

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