OpenSearch 加了 boost 排名没变：filter 子句不参与打分

想在 bool 查询里给电影类型 drama 加权，把 boost 写进了 filter 子句，结果排序一点没变。根因是 filter 只负责「过不过」，不参与相关性打分，写在里面的 boost 被直接忽略。把 boost 挪到 should 或 must 这类「打分子句」上才生效。适用 OpenSearch 3.x。

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

业务场景：接着从零跑通 OpenSearch 本地搜索服务的 movies 索引。搜 wind rise 时，想让 drama 类型的电影排前面一点，于是写了个 bool，把 term 放进了 filter 并给它 boost: 2。结果返回顺序和没加 boost 时一模一样。
环境：OpenSearch 3.x（Docker latest 镜像），单节点，索引 movies（title: text、year: integer、genre: keyword），security 插件开启。
关键区分：请求没报错，文档也命中了，只是「顺序」没按预期变——问题出在把 boost 放在了不算分的子句里。

StackTrace（现象：加了 boost 排序不变）

两版请求返回的 hits 顺序一致，_score 也完全一样。下面这个是把 boost 写进 filter 的「看似正确、实则无效」的写法，返回顺序仍是纯相关性顺序：

{
  "hits": {
    "total": { "value": 3, "relation": "eq" },
    "max_score": 0.5023,
    "hits": [
      { "_id": "1", "_score": 0.5023, "_source": { "title": "Let the Wind Rise", "genre": "drama" } },
      { "_id": "3", "_score": 0.4119, "_source": { "title": "The Rise of Machines", "genre": "scifi" } },
      { "_id": "2", "_score": 0.3987, "_source": { "title": "Gone with the Wind", "genre": "drama" } }
    ]
  }
}

drama 的文档（id 1、id 2）并没有因为 boost: 2 而浮到前面，_score 和没 boost 时没有区别。

Reproduce（复现代码）

这个无效写法长这样——boost 加在 filter 里的 term 上：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "bool": {
        "must":   [ { "match": { "title": "wind rise" } } ],
        "filter": [ { "term": { "genre": { "value": "drama", "boost": 2 } } } ]
      }
    }
  }'

对照：把同样的 term 挪到 should（打分子句）上：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "bool": {
        "must":   [ { "match": { "title": "wind rise" } } ],
        "should": [ { "term": { "genre": { "value": "drama", "boost": 2 } } } ]
      }
    }
  }'

判定标准：第一个请求 drama 文档分数无变化；第二个请求 drama 文档（id 1、id 2）的 _score 相比原来变大、排到前面，即说明 boost 位置对结果的影响差异。

Root Cause（根因分析）

filter 是「过滤器」，不是「打分器」

bool 的四个子句分工不同：must 和 should 参与相关性打分，它们命中的程度会改变 _score；filter 和 must_not 只做「这条文档要不要留下」的判断，不参与打分。所以 filter 里的 boost 没有任何可以被乘进去的分数，写了也被忽略。

官方 Boolean query 文档把 filter 定义为「必须匹配但不对得分做贡献」的子句（docs 用 must appear but do not contribute to the score 这类措辞），boost 只有作用在打分子句上才有意义。

constant_score 里 boost 同理无效

constant_score 把整个查询固定成一个常数值分数（默认 1）。它内部套 filter 时，boost 依然不生效——因为分数本来就是写死的常量，boost 无处可乘。官方 Constant score query 文档明确 boost 在这里不改变任何东西。想通过「固定分数 + 叠加」来实现加权，要换 function_score 的 weight + boost_mode，而不是往 constant_score 里塞 boost。

The Fix（解决方案）

方案一：boost 移到 should / must 打分子句（首选）

想让 drama 加权，就把 term 从 filter 挪到 should，boost 跟着走：

curl -sk -u admin:Devfix@2026 -X GET "https://localhost:9200/movies/_search?pretty" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "bool": {
        "must":   [ { "match": { "title": "wind rise" } } ],
        "should": [ { "term": { "genre": { "value": "drama", "boost": 2 } } } ]
      }
    }
  }'

should 参与打分，drama 文档的 _score 就会在原相关性的基础上往上加，排序随之改变。

方案二：用 match 给文本字段加字段级 boost

如果加权目标是「标题命中比类型命中更重要」，直接在 match 上写 boost： { "match": { "title": { "query": "wind rise", "boost": 2 } } }。这是最直接的「字段 / 子句级加权」，落在打分子句里，一定生效。

注意事项

filter / must_not 里的 boost 一律无效，别写在那里，写了也只是看起来有用。
should 的加权有两个前提：没有 must 时，should 要凑够 minimum_should_match 才决定「过不过」；有 must 时，should 纯粹是加分项，正好用来做加权。
加权后想知道分数到底变了多少，配合 explain API 看 boost 那一项，别只看最终顺序。

References（参考来源）

Boolean query — OpenSearch 官方文档opensearch-docs
Constant score query — OpenSearch 官方文档opensearch-docs