Spring Boot JPQL数组参数NULL判断触发数组值参数绑定异常

该异常由JPQL参数类型解析冲突导致：

• 你在JPQL中编写的:reviews IS NULL判断，会让Hibernate（Spring Data JPA默认持久化实现）在解析参数时，优先将:reviews识别为单个Double类型的标量值，而非数组类型。
• 当后续解析到r.review IN (:reviews)逻辑时，Hibernate发现实际传入的参数是数组类型，和之前解析的单个Double类型不匹配，就会抛出数组参数绑定的非法参数异常。
• 额外注意：你使用的基本类型数组double[]本身不支持存储null值，作为可空筛选参数本身就存在设计缺陷。

你可以根据项目实际情况选择以下任意一种方案实现需求：

方案1：最小改动，调整@Query写法和参数类型 #

不需要引入额外组件，仅修改Repository层代码即可：

1. 将入参的double[]替换为包装类型数组Double[]，解决基本类型数组无法为null的问题
2. 用SpEL表达式处理reviews参数的空判断，避免Hibernate提前错误解析参数类型
3. 修正Pageable参数的命名（Java变量不推荐大写开头，避免参数绑定异常）

修改后的Repository代码如下：

@Query("SELECT r FROM Restaurant r WHERE " +
            "(:name IS NULL " + 
            "OR r.name LIKE CONCAT('%',:name, '%')) " +  
            "AND (:city IS NULL " +
            "OR r.city = :city) " + 
            "AND (:#{#reviews} IS NULL " +
            "OR r.review IN (:reviews)) ")
Page<Restaurant> filter(Pageable page, String name, String city, Double[] reviews);

方案2：使用JPA Specification动态拼接条件（多筛选场景推荐） #

如果后续筛选条件还会迭代增加，硬编码JPQL的维护成本会越来越高，推荐用Specification动态拼接查询条件，从根源上避免JPQL参数解析冲突问题：

1. 首先让你的Repository接口继承JpaSpecificationExecutor：

public interface RestaurantRepository extends JpaRepository<Restaurant, Long>, JpaSpecificationExecutor<Restaurant> {
    // 原有其他数据库操作方法保留即可
}

2. 在业务层根据入参非空判断动态拼接查询条件：

public Page<Restaurant> filter(Pageable pageable, String name, String city, Double[] reviews) {
    Specification<Restaurant> querySpec = (root, query, cb) -> {
        List<Predicate> conditions = new ArrayList<>();
        // 拼接名称模糊查询条件
        if (name != null) {
            conditions.add(cb.like(root.get("name"), "%" + name + "%"));
        }
        // 拼接城市等值查询条件
        if (city != null) {
            conditions.add(cb.equal(root.get("city"), city));
        }
        // 拼接评分范围查询条件
        if (reviews != null && reviews.length > 0) {
            conditions.add(root.get("review").in(Arrays.asList(reviews)));
        }
        return cb.and(conditions.toArray(new Predicate[0]));
    };
    return restaurantRepository.findAll(querySpec, pageable);
}

这种写法的空判断完全在Java代码中完成，非空才会拼接对应SQL条件，不会出现JPQL的参数类型解析问题，后续新增筛选条件只需要新增对应的if判断即可，维护成本更低。

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