Quarkus PanacheQuery多筛选异常：HorseType列表传参显示为null

可能的原因分析 #

1. HorseType枚举的toString()方法返回null
   虽然日志显示breedList Size: 2，但每个枚举实例的toString()可能返回null，导致最终参数列表实际是[null, null]，MongoDB驱动输出时简化显示为[null]。

2. 手动拼接查询语句的参数映射问题
   手动构建查询字符串和参数Map时，Panache MongoDB对集合类型参数的处理可能存在隐性兼容问题，导致参数未正确绑定。

3. 实体字段与数据库存储名不匹配
   若Horse实体中HorseType字段的MongoDB存储名（比如小写horseType）与查询语句中的HorseType不一致，虽不会直接导致参数显示为null，但可能间接引发查询逻辑异常。

分步解决方法 #

1. 验证breedList的实际元素内容 #

在打印size的代码后添加元素打印，确认每个元素是否为null：

System.out.println("breedList Size: " + breedList.size());
System.out.println("breedList Elements: " + breedList); // 新增元素打印

如果输出显示元素为null，需修正HorseType枚举的toString()方法，确保返回有效字符串：

public enum HorseType {
    THOROUGHBRED, QUARTER_HORSE;

    @Override
    public String toString() {
        return this.name(); // 直接返回枚举名称，或自定义业务需要的字符串
    }
}

2. 替换为Panache链式查询API #

手动拼接查询字符串易出错，推荐使用Panache原生链式API构建查询，自动处理参数映射：

public List<Horse> find(Filter filter) {
    PanacheQuery<Horse> query = Horse.findAll(Sort.by(filter.getSortBy().toString(), filter.getSortByDirection()));

    if (StringUtils.isNotEmpty(filter.getName())) {
        query = query.where("Name like :name", Parameters.with("name", filter.getName()));
    }
    if (filter.getHorseTypeList() != null && !filter.getHorseTypeList().isEmpty()) {
        List<String> breedList = filter.getHorseTypeList().stream()
                .map(HorseType::toString)
                .collect(Collectors.toList());
        query = query.where("HorseType in (:horsetypes)", Parameters.with("horsetypes", breedList));
    }

    return query.page(Page.of(filter.getPageNumber(), filter.getResultsPerPage())).list();
}

3. 验证实体字段与数据库存储名一致性 #

检查Horse实体类的字段映射，确保查询语句中的字段名与数据库存储名一致：

@Entity
public class Horse extends PanacheMongoEntity {
    public String Name;
    // 若数据库存储名为horseType，需修改查询语句为horseType，或添加@Field指定存储名
    public HorseType HorseType;
    // 其他字段...
}

4. 排查版本兼容性问题 #

若以上方法无效，检查Quarkus Panache MongoDB的版本是否存在集合参数传递的已知bug，尝试升级至最新稳定版。

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