OpenSearch 加了筛选条件后分面计数只剩一个：query 与 post_filter 的区别

搜索结果页的分面计数突然只剩被选中的那一项，通常是把筛选条件写进了 query：聚合的作用域就是 query 命中的文档集，过滤完再统计，其他选项自然归零。把同一个条件挪到 post_filter，聚合在过滤之前计算，hits 只剩 1 条而分面仍显示 drama 3 / documentary 1。这是官方 faceted search 教程推荐的「保留分面选项」做法。适用 OpenSearch 2.x / 3.x，本文对 3.9.0 校验。

Issue & Env（案发现场与环境）

业务场景：movies 索引里有 5 条电影（drama 3、scifi 1、documentary 1），结果页做了 genre 分面。用户点选「scifi」之后，本来期望看到「drama 3、documentary 1」仍然可选，实际只剩一个 scifi: 1，等于失去了切换筛选的能力。
环境：OpenSearch 3.9.0，Docker 单节点，索引 movies（1 主分片、0 副本），genre 是 keyword。
关键区分：不是聚合写错了，也不是数据少了。两次请求的 hits 都是 1 条，差别只在 aggregations 的桶——一个只剩 scifi，一个保留全集。

StackTrace（两次响应对比）

同一份数据、同一个筛选条件，先写进 query：

{
  "hits": { "total": { "value": 1, "relation": "eq" } },
  "aggregations": {
    "by_genre": {
      "buckets": [
        { "key": "scifi", "doc_count": 1 }
      ]
    }
  }
}

再写进 post_filter：

{
  "hits": { "total": { "value": 1, "relation": "eq" } },
  "aggregations": {
    "by_genre": {
      "buckets": [
        { "key": "drama", "doc_count": 3 },
        { "key": "scifi", "doc_count": 1 },
        { "key": "documentary", "doc_count": 1 }
      ]
    }
  }
}

hits 一样，分面一个塌了、一个没塌。这就是全部现象。

Reproduce（复现代码）

前提：movies 索引已建好并导入 5 条文档，步骤与示例值见从零跑通 OpenSearch 本地搜索服务。

把筛选写进 query：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 0,
    "query": { "term": { "genre": "scifi" } },
    "aggs": { "by_genre": { "terms": { "field": "genre" } } }
  }'

回到 aggregations.by_genre.buckets 看：只有一个 scifi 桶。

换成 post_filter：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 0,
    "post_filter": { "term": { "genre": "scifi" } },
    "aggs": { "by_genre": { "terms": { "field": "genre" } } }
  }'

这次三个桶都在，drama 仍是 3。

判定标准：两次请求的 hits.total.value 都是 1，但前者的桶只有 1 个、后者有 3 个，即复现成功。把 size 设成 0 是为了只看聚合；要同时看命中列表就去掉 size。

Root Cause（根因分析）

聚合的作用域是 query 命中的文档集

一次 _search 的执行顺序可以粗分为：先用 query 筛出文档集 → 在这个集合上跑 aggs → 返回 hits 和 aggregations。筛选条件写进 query，文档集在聚合之前就被缩到 1 条，terms 只能在这个子集里数数，其他类型的桶连生成的机会都没有。

post_filter 是「最后一道闸」

post_filter 的位置在聚合之后、返回 hits 之前。官方 faceted search 教程对此的表述是：post_filter 在聚合计算完成之后再过滤搜索结果，因此分面反映的是未过滤的数据集。用它实现「选了红色 T 恤，颜色分面仍显示红、蓝、其他全部颜色」，正是结果页需要的交互。

query 与 post_filter 的取舍

写进 query：参与相关性打分，聚合跟着收窄。适合「这个条件就是搜索意图的一部分」，比如用户输入的关键词。
写进 post_filter：不参与打分，只裁 hits。适合「用户在结果页上追加的筛选」，这样分面才能保留全集计数。
想看「选中某个类型后，其他维度还剩多少」（例如选了 scifi，再看每个年份区间有几部），用 filter 聚合：它生成一个独立桶，桶内子聚合只在该子集上计算，不影响外层的其他分面。

The Fix（解决方案）

方案一：结果页筛选一律走 post_filter

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 0,
    "post_filter": { "term": { "genre": "scifi" } },
    "aggs": {
      "by_genre": { "terms": { "field": "genre" } },
      "by_year":  { "terms": { "field": "year" } }
    }
  }'

两个分面都保持全集口径，用户在任何时候都能看到「切到别的类型还有多少条」。

方案二：需要「条件内统计」时用 filter 聚合

如果某个分面的数字本来就该跟着筛选变（比如「当前选中的类型下，各年份的分布」），把它包进 filter 聚合，不要改全局 query：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 0,
    "aggs": {
      "all_genres": { "terms": { "field": "genre" } },
      "scifi_years": {
        "filter": { "term": { "genre": "scifi" } },
        "aggs": { "years": { "terms": { "field": "year" } } }
      }
    }
  }'

all_genres 是全集口径，scifi_years 是子集口径，一次请求拿到两套数字。

注意事项

post_filter 只影响 hits，不会让 aggregations 变窄，也不会改变相关性得分。
关键词搜索仍然写在 query 里；post_filter 是给结果页追加的筛选留的位置，两者可以同时存在。
每次请求都带 size: 0 时看不到 hits，验证分面时够用；要看列表就设正常的 size。
filter 聚合与 post_filter 不是二选一：前者决定「哪些统计跟着子集走」，后者决定「列表要不要裁」。
聚合本身怎么写，见从零跑通 OpenSearch 聚合与分面。

References（参考来源）

Faceted search — OpenSearch 官方教程opensearch-docs
Filter aggregation — OpenSearch 官方文档opensearch-docs
Aggregations — OpenSearch 官方文档opensearch-docs