Elastic Search API Facets使用报错：如何正确实现嵌套字段统计？

错误原因 #

你提交的请求格式不符合Elasticsearch Search API要求，核心问题有两个：

1. Elasticsearch从2.x版本开始已弃用facets参数，改用aggregations（聚合）实现统计功能；
2. 你参考的是App Search的文档，但App Search API格式与Elasticsearch原生API完全不同，导致参数结构不匹配。

正确实现方案（Elasticsearch原生API） #

要获取field2.innerField2的不同取值及计数，使用terms聚合即可，请求体示例如下：

{
  "query": {
    "bool": {
      "must": [
        // 替换为你的实际查询条件，比如{"match_all": {}}表示查询所有文档
        {"match_all": {}}
      ]
    }
  },
  "size": 0, // 仅需聚合结果时，设置为0可避免返回无关文档，提升性能
  "aggs": {
    "innerField2_count": { // 自定义聚合名称，可任意修改
      "terms": {
        "field": "field2.innerField2", // 嵌套字段的完整路径
        "size": 10, // 返回前10个出现次数最多的取值
        "order": {
          "_count": "desc" // 按计数降序排列
        }
      }
    }
  }
}

注意事项 #

• 如果field2.innerField2是text类型，直接使用terms聚合会报错，需改用其keyword子字段（前提是字段映射中已配置），即field: "field2.innerField2.keyword"；
• 确保字段的映射支持聚合：若为text类型，需开启fielddata（不推荐，性能较差）或配置keyword子字段。

若使用App Search API（对应你参考的文档） #

如果是调用App Search的搜索接口，请求格式需调整为：

{
  "query": "你的查询关键词",
  "facets": {
    "field2.innerField2": {
      "type": "value",
      "size": 10,
      "sort": {"count": "desc"}
    }
  }
}

注意：App Search的API端点与Elasticsearch原生API不同，需使用App Search专属的搜索地址。

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