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