如何基于HashMap与QueryBuilder实现双路径OR关系的PathPredicateEvaluator查询？

看起来你已经把单路径的HashMap配置玩得很溜了，要实现两个路径的OR关系查询，一般有几种常见的处理思路，具体取决于你所用QueryBuilder的实现逻辑，下面给你几个实用方案：

1. 直接传入路径数组（最简洁的方式） #

不少QueryBuilder会自动把数组类型的参数解析成OR关系的多值条件，你可以直接把路径值改成字符串数组试试：

map.put("path", new String[]{"/content", "/docs"});
// 原有的配置参数会统一应用到所有路径条件上
map.put("path.exact", "true");
map.put("path.flat", "true");
map.put("path.self", "true");

这种方式最省心，如果你的QueryBuilder支持数组参数解析，这绝对是首选。

2. 使用带索引的OR参数命名 #

要是数组方式不生效，很多查询构建器支持通过数字索引+OR标记的方式定义多条件OR关系，给每个路径条件单独配置参数即可：

// 第一个路径条件
map.put("path.1", "/content");
map.put("path.1.exact", "true");
map.put("path.1.flat", "true");
map.put("path.1.self", "true");

// 第二个路径条件，用.or标记和第一个条件的OR关联
map.put("path.2.or", "/docs");
map.put("path.2.exact", "true");
map.put("path.2.flat", "true");
map.put("path.2.self", "true");

这种命名规范在Java生态的查询工具里很常见，通过数字索引区分不同条件，.or后缀用来标记当前条件和前一个是OR逻辑。

3. 直接用QueryBuilder的链式API构建OR条件 #

如果你的QueryBuilder提供了更直观的链式调用API，建议直接脱离HashMap，用API来构建OR逻辑，可读性会强很多：

// 假设你的QueryBuilder有类似的方法结构
QueryBuilder queryBuilder = new QueryBuilder();

// 添加第一个路径条件
queryBuilder.withPath("/content")
            .exactMatch(true)
            .flat(true)
            .self(true);

// 追加OR关系的第二个路径条件
queryBuilder.or()
            .withPath("/docs")
            .exactMatch(true)
            .flat(true)
            .self(true);

// 最后转换成HashMap（如果业务需要的话）
Map<String, Object> map = queryBuilder.toMap();

这种方式虽然需要调整一点代码结构，但逻辑更清晰，也不容易出错。

小建议 #

要是以上方法都不生效，你可以先调试下当前单路径查询生成的最终语句（比如SQL、Elasticsearch DSL等），看看参数是怎么被解析的，反向推导双OR条件的参数格式——这往往是最靠谱的排查方式。

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