本文介绍在 Elasticsearch 父子关系映射下，使用 hasChildQuery 精确检索所有存在至少一个子文档的父文档的完整实现方法，涵盖 Java REST Client 代码示例、关键参数说明及常见注意事项。
本文介绍在 elasticsearch 父子关系映射下，使用 `haschildquery` 精确检索所有存在至少一个子文档的父文档的完整实现方法，涵盖 java rest client 代码示例、关键参数说明及常见注意事项。
在 Elasticsearch 中，当采用父子（Parent-Child）关系建模（而非嵌套对象 nested）时，常因子文档高频更新、独立索引等需求而选择此设计。此时，若需筛选出“有子文档关联”的父文档（例如：查找所有已分配权限的资源实例），不能依赖字段匹配或简单聚合，而必须使用专门的连接查询（Join Query）。
核心方案是使用 JoinQueryBuilders.hasChildQuery() —— 这是当前 Elasticsearch Java High Level REST Client（及 Spring Data Elasticsearch 4.0+）中替代已废弃 QueryBuilders.hasChildQuery() 的标准方式。其语法结构为：
JoinQueryBuilders.hasChildQuery(
"child_type_name", // 子文档的 type 名（Elasticsearch 7.x+ 后实际为 _parent 字段指定的 relation 值）
innerQuery, // 子文档需满足的查询条件（如 matchAllQuery() 表示任意子文档存在即可）
scoreMode // 评分模式，通常设为 ScoreMode.None（避免子文档相关性干扰父文档排序）
)
✅ 完整可运行示例（Spring Data Elasticsearch）：
import static org.springframework.data.elasticsearch.core.query.QueryBuilders.*;
import static org.springframework.data.elasticsearch.core.query.JoinQueryBuilders.*;
// 构建复合查询：父文档类型为 "parent"，且至少有一个关联的 "child" 类型子文档
Query query = new NativeSearchQueryBuilder()
.withQuery(boolQuery()
.must(matchQuery("relation_type", "parent")) // 确保是父文档（通过业务字段标识）
.must(hasChildQuery("child", matchAllQuery(), ScoreMode.None)) // 关键：存在任意子文档
)
.withPageable(PageRequest.of(0, 10))
.build();
SearchHits<asset> searchHits = elasticsearchRestTemplate.search(query, Asset.class);</asset>
⚠️ 注意事项：
-
child_type_name参数不是 mapping 中的_type（ES 7.0+ 已弃用 type），而是父子关系定义中join字段的relations所声明的子关系名称，例如："relations": {"parent": "child"}→ 此处填"child"。 -
ScoreMode.None是推荐设置：因hasChildQuery默认会将子文档评分合并至父文档，若仅做存在性判断（非相关性排序），应禁用评分以提升性能与结果确定性。 -
matchAllQuery()表示“只要存在至少一个子文档即匹配”；如需进一步约束子文档内容（如status: "active"），可替换为boolQuery().must(...)等任意合法子查询。 - 父子查询性能低于嵌套查询，建议配合合理的
routing设置（父子文档同路由）以减少跨分片查询开销。
总结：JoinQueryBuilders.hasChildQuery() 是当前版本中检索“拥有子文档的父文档”的标准且高效方式。正确理解 relation 名称、合理设置 ScoreMode、并结合业务字段过滤，即可稳健支撑权限、实例、订单等典型父子场景的数据检索需求。
