OpenSearch function_score 忘写 query 返回全库（match_all）

用 function_score 想给热门电影加权，忘了写顶层 query，结果请求把 movies 索引里的文档全返回了，每篇分数还都差不多。根因是 function_score 省略 query 时内部走 match_all，每篇文档的 base score 都是 1。给 function_score 写显式 query，或外层套 bool 的 filter 把范围卡住。适用 OpenSearch 3.x。

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

业务场景：接着从零跑通 OpenSearch 本地搜索服务的 movies 索引（5 条电影）。想「按年份越新排越前」，用 function_score 的 field_value_factor 对 year 加权，却忘了写 query。结果不仅 5 条全回来了，连本不该命中的 Deep Sea Chronicles、Windmill Valley 也躺进了结果里。
环境：OpenSearch 3.x（Docker latest 镜像），单节点，索引 movies，security 插件开启。
关键区分：没报错、分数也算出来了，但「命中范围」不对——本来只想对「匹配了关键词的文档」加权，结果变成对「整个索引」加权。

StackTrace（现象：全库命中 + base score 为 1）

省略顶层 query 的返回体，total 是全部 5 条，每条 _score 都被 field_value_factor 从 base 1 重新算成接近 1 的值：

{
  "hits": {
    "total": { "value": 5, "relation": "eq" },
    "max_score": 2.021,
    "hits": [
      { "_id": "3", "_score": 2.021, "_source": { "title": "The Rise of Machines", "year": 2021, "genre": "scifi" } },
      { "_id": "1", "_score": 1.013, "_source": { "title": "Let the Wind Rise", "year": 2013, "genre": "drama" } },
      { "_id": "2", "_score": 0.939, "_source": { "title": "Gone with the Wind", "year": 1939, "genre": "drama" } }
    ]
  }
}

total 是 5，而不是「匹配了某个关键词」的那几条——因为这个请求压根没有关键词过滤。

Reproduce（复现代码）

错误的写法——function_score 里只有 functions，没有顶层 query：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "function_score": {
        "functions": [
          { "field_value_factor": { "field": "year", "modifier": "log1p" } }
        ],
        "boost_mode": "multiply"
      }
    }
  }'

对照正确写法——function_score 内补上 query：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "function_score": {
        "query": { "match": { "title": "wind rise" } },
        "functions": [
          { "field_value_factor": { "field": "year", "modifier": "log1p" } }
        ],
        "boost_mode": "multiply"
      }
    }
  }'

判定标准：第一个请求 total 是 5（全库）；第二个请求 total 是 3（只命中 wind rise 相关的三条），即说明 query 的作用。

Root Cause（根因分析）

function_score 省略 query 时，默认是 match_all

function_score 不是独立的打分器，它是「一个查询 + 一套改分函数」的包装。它的顶层 query 决定了「哪些文档先被命中」，functions 决定「命中的这些文档分数怎么改」。官方 Function score query 文档写得很直接：If you omit the top-level query parameter, function_score runs on match_all, so every document in the index matches and receives a base query score of 1.

于是省略 query 后，match_all 让全库每篇文档都以 base score 1 进入 functions，再被你写的 field_value_factor 统一重算——结果就是「全库命中、分数全是 1.0 附近」。

这是「改怎么排」还是「改返回哪些」的边界被搞混了

function_score 的职责是「让已命中的文档重新排序」，不是「决定哪些文档命中」。决定命中范围的永远是 query（或外层 bool）。把它当成了能自动限定范围的工具，才会写出只有 functions、没有 query 的请求。

The Fix（解决方案）

方案一：function_score 内写显式 query（首选）

在 function_score 里补上 query，让「命中范围」和「改分函数」各司其职：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "function_score": {
        "query": { "match": { "title": "wind rise" } },
        "functions": [
          { "field_value_factor": { "field": "year", "modifier": "log1p" } }
        ],
        "boost_mode": "multiply"
      }
    }
  }'

方案二：只对某类文档加权，用 functions 里的 filter

如果意图是「只给满足某条件的文档加权、其他文档分数不动」，就把条件写进 functions 里每个 function 的 filter——{ "filter": { "term": { "genre": "drama" } }, "weight": 2 }。这样命中的文档里，drama 的被加权，非 drama 的走原分数。

注意事项

判断请求有没有「命中范围」：看 query 是否显式给了 match / bool / term 等。只有 functions 而没有 query，就等同于 match_all。
加权的正确心智模型：query 定「哪些文档进来」，functions 定「进来的文档分数怎么改」。先想清楚前者，再写后者。
想同时「限定范围 + 加权」，优先用 function_score { query + functions }；需要多个独立改分规则时，再往 functions 的每个 function 里加 filter。
配合 explain API 看最终 _score 里 match_all 的 base 分是 1，能一眼判断出「是不是忘了写 query」。

References（参考来源）

Function score query — OpenSearch 官方文档opensearch-docs