Spring Data JPA查询触发unexpected AST node: {vector}错误如何解决？

问题原因 #

报错的根因是HQL不支持直接对集合参数做is null判断：
当你传入多元素集合时，Hibernate会把集合参数自动展开成多个独立的占位符（比如你传入2个元素的unitNames列表，:unitNames会被拆成:unitNames_0、:unitNames_1），此时你写的:unitNames is null会被解析为语法错误的(:unitNames_0, :unitNames_1 is null)，进而抛出AST节点异常。
而单元素集合展开后只有1个占位符，刚好符合单个参数 is null的语法规则，所以不会触发报错。

可行解决方案 #

方案1：修改HQL判空逻辑（最快适配现有代码） #

把所有集合参数的is null判断替换为HQL的is empty判断，同时在业务层对入参做统一处理即可：

1. 修改@Query中的集合条件：

@Query("select r from Research r " +
            "left join r.fundingAgencies fundingAgencies " +
            "left join r.researchers researchers " +
            "where (:budgetStart is null or :budgetEnd is null or  r.budget between :budgetStart and :budgetEnd )" +
            "and (:startDate is null or r.startDate >= :startDate) " +
            "and (:endDate is null or r.endDate <= :endDate) " +
            // 替换为is empty判断
            "and (:agencyNames is empty or fundingAgencies.agencyName in (:agencyNames)) " +
            "and (:unitNames is empty or r.deliveryUnit.unitName in (:unitNames) )" +
            "and (:names is empty or researchers.name in (:names) ) " +
            "and (:researchStatuses is empty or r.researchStatus in (:researchStatuses))" +
            "and r.deleted = false")

2. 在Service层调用Repository前，对所有集合入参做空值兜底：

// 所有集合参数统一处理，null值转为空集合
if (unitNames == null) unitNames = Collections.emptyList();
if (agencyNames == null) agencyNames = Collections.emptyList();
if (names == null) names = Collections.emptyList();
if (researchStatuses == null) researchStatuses = Collections.emptyList();

方案2：使用JPA Specification动态构建查询（更适合后续扩展） #

如果后续筛选条件还会迭代，建议改用Specification动态拼接查询条件，完全避免硬编码HQL的集合判空问题：

1. 让你的Repository接口继承JpaSpecificationExecutor<Research>：

public interface ResearchRepository extends JpaRepository<Research, Long>, JpaSpecificationExecutor<Research> {
}

2. 业务层根据入参动态拼接条件，集合为空时直接不添加该过滤条件即可。

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