Elasticsearch的QueryBuilders.nestedQuery在Lucene 9中的等效实现方式

在Lucene 9中，你可以直接使用NestedQuery类实现和Elasticsearch 7.12中nestedQuery等价的功能，同时自行处理ignoreUnmapped逻辑，具体实现如下：

核心查询构建 #

Lucene的NestedQuery与Elasticsearch的嵌套查询参数一一对应：

• 原代码中的nestedPath对应NestedQuery的路径参数
• 内部查询query直接传入构造函数
• ScoreMode.Min对应NestedQuery.ScoreMode.MIN枚举值

处理ignoreUnmapped=true逻辑 #

Lucene的NestedQuery没有内置的ignoreUnmapped参数，需要通过检查索引字段是否存在来模拟该行为：如果指定的嵌套路径无对应字段，返回MatchNoDocsQuery（无匹配结果），避免抛出异常。

完整代码示例 #

import org.apache.lucene.search.Query;
import org.apache.lucene.search.NestedQuery;
import org.apache.lucene.search.MatchNoDocsQuery;
import org.apache.lucene.index.IndexReader;
import org.apache.lucene.index.IndexableField;

// 假设已准备好内部查询query、嵌套路径nestedPath，以及IndexReader实例reader
Query nestedLuceneQuery;

// 检查嵌套路径对应的字段是否存在于索引中
boolean isNestedFieldMapped = false;
for (IndexableField field : reader.getSchema().getFields()) {
    if (field.name().startsWith(nestedPath + ".")) {
        isNestedFieldMapped = true;
        break;
    }
}

if (isNestedFieldMapped) {
    // 构建嵌套查询，使用MIN评分模式
    nestedLuceneQuery = new NestedQuery(
        nestedPath,
        query,
        NestedQuery.ScoreMode.MIN
    );
} else {
    // 对应ignoreUnmapped=true，字段不存在时返回无匹配结果
    nestedLuceneQuery = new MatchNoDocsQuery();
}

说明 #

• NestedQuery.ScoreMode枚举包含MIN、MAX、AVG等选项，完全对应Elasticsearch的ScoreMode类型
• 字段存在性检查通过遍历索引schema实现，确保只有当嵌套字段实际存在时才构建NestedQuery，否则返回空匹配，和Elasticsearch中ignoreUnmapped=true的行为一致

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