如何在JPQL中设置可选参数？解决IN子句参数报错问题

原本的JPQL查询代码如下：

@Query(value = "SELECT stud FROM Student stud where stud.name = :studentName AND stud.age IN :studentAgeList")
List<Student> getStudents(
            @Param("studentName ") String studentName, 
            @Param("studentAgeList") List<Integer> studentAgeList
         )

想要把studentAgeList设为可选参数，修改后的代码如下：

@Query(value = "SELECT stud FROM Student stud where stud.name = :studentName AND (:studentAgeList IS NULL OR stud.age IN :studentAgeList))
List<Student> getStudents(
            @Param("studentName ") String studentName, 
            @Param("studentAgeList") List<Integer> studentAgeList
         )

运行后报错：unexpected AST node:

1. JPQL不支持直接对集合类型参数用IS NULL做判断，这属于语法不兼容
2. 修改后的JPQL存在语法错误：末尾多了一个右括号；@Param("studentName ")里的参数名多了空格，会导致参数绑定失败

方式一：修正JPQL语法，兼容空集合/Null参数 #

直接调整JPQL，同时处理参数为Null和空集合的情况：

@Query(value = "SELECT stud FROM Student stud WHERE stud.name = :studentName AND (:studentAgeList IS NULL OR :studentAgeList IS EMPTY OR stud.age IN :studentAgeList)")
List<Student> getStudents(
            @Param("studentName") String studentName, 
            @Param("studentAgeList") List<Integer> studentAgeList
         );

要点：

• 同时判断集合参数是NULL或者空集合，只要满足其一，年龄过滤条件就自动失效
• 去掉了参数名里多余的空格，保证参数能正确绑定
• 删除了原代码里多出来的右括号，修复语法错误

方式二：给参数设置默认空集合 #

在方法参数里给集合设置默认值，避免传入Null，简化JPQL的判断：

@Query(value = "SELECT stud FROM Student stud WHERE stud.name = :studentName AND (:studentAgeList IS EMPTY OR stud.age IN :studentAgeList)")
List<Student> getStudents(
            @Param("studentName") String studentName, 
            @Param("studentAgeList") @Nullable List<Integer> studentAgeList = new ArrayList<>()
         );

要点：

• 用@Nullable标记参数可以为空，同时默认传入空集合，这样JPQL里只用判断IS EMPTY就行
• 写法更简洁，减少JPQL里的判断逻辑

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

如果后续还要加更多可选参数，推荐用Spring Data JPA的动态查询来实现，示例代码：

public List<Student> getStudents(String studentName, List<Integer> studentAgeList) {
    return studentRepository.findAll((root, query, cb) -> {
        // 先构建姓名匹配条件
        Predicate predicate = cb.equal(root.get("name"), studentName);
        // 只有当年龄集合非空时，才添加年龄过滤条件
        if (studentAgeList != null && !studentAgeList.isEmpty()) {
            predicate = cb.and(predicate, root.get("age").in(studentAgeList));
        }
        return predicate;
    });
}

要点：

• 动态拼装查询条件，灵活度更高
• 适合有多个可选参数的复杂场景

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