Java Hibernate QueryDSL查询数组类字段匹配任意值抛NPE问题

核心诱因 #

• QueryDSL API使用错误：any()是QueryDSL专为JPA关联集合（比如@OneToMany、@ManyToMany映射的关联表集合）设计的操作符，你当前的shopGroupIds是通过自定义TypeConverter将PostgreSQL原生数组字段映射为Java List，不属于JPA关联关系，QueryDSL无法识别该字段为单表数组字段，会错误生成关联表join逻辑，找不到对应的关联表映射关系，最终触发空指针。移除request.shopGroupIds.any().in(shopGroupIds)后不会生成错误的关联查询逻辑，所以流程可以正常运行。
• 自定义类型转换器类型不匹配：你的ListTypeConverter在存储UUID数组时，调用createArrayOf传入的类型是text，但数据库中shop_group_ids实际存储的是UUID类型数组，参数绑定时类型不匹配也会加重序列化/反序列化异常风险。
• 生成SQL和实际表结构不匹配：生成的SQL中inner join request_105380127.shopGroupIds这段逻辑试图关联不存在的子表，执行时ORM框架解析该关联关系时找不到对应元数据，直接抛出空指针。

修复方案 #

• 替换any()操作符，使用PostgreSQL原生数组重叠函数&&实现「数组至少包含一个指定元素」的判断，通过QueryDSL模板表达式编写：

// 替换原来的request.shopGroupIds.any().in(shopGroupIds)
Predicate shopGroupPredicate = Expressions.booleanTemplate(
    "{0} && {1}::uuid[]",
    request.shopGroupIds,
    shopGroupIds.stream().map(UUID::toString).toList()
);
// 再将该predicate和原有条件做and拼接即可

• 修复自定义ListTypeConverter的数组类型声明，存储时指定为uuid类型匹配字段定义：

@Override
public void nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session) throws HibernateException, SQLException {
    Connection c = st.getConnection();
    if (value == null) {
        st.setNull(index, Types.ARRAY);
    } else {
        // 把text改为uuid匹配字段类型
        st.setArray(index, c.createArrayOf("uuid", ((List<?>) value).toArray()));
    }
}

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