OpenSearch中script_score重复执行致分数异常的原因与解决方法

这种现象的核心是OpenSearch的bool查询分数计算逻辑导致的：

• 当bool查询中同时存在must和should子句时，文档只要满足must的条件，所有匹配的should子句都会各自贡献分数，最终总分是这些分数的累加。
• 如果你把script_score嵌套在每个should子句内部，那么每个匹配的should都会触发一次脚本执行，脚本返回的分数会被重复累加。你的示例中文档匹配了3个should条件，所以出现了6148*3的总分。

以下几种方案可以确保脚本仅执行一次，避免分数累加：

方案1：用外层function_score统一处理脚本评分 #

把script_score移到function_score的外层，脱离bool查询的子句结构，这样不管内部bool匹配多少个should，脚本只会执行一次。关键是设置boost_mode: "replace"，让脚本结果直接替换原始查询的分数：

{
  "query": {
    "function_score": {
      "query": {
        "bool": {
          "must": [/* 你的must条件 */],
          "should": [/* 你的should条件 */],
          "minimum_should_match": 1
        }
      },
      "script_score": {
        "script": {
          "source": "return Integer.parseInt(doc['_id'].value);"
        }
      },
      "boost_mode": "replace"
    }
  }
}

boost_mode的其他可选值（如multiply/sum）可以根据需求调整，但replace是最直接让脚本结果成为最终分数的选项。

方案2：将多个should条件合并到单个script_score查询中 #

把所有should条件打包成一个子查询，再嵌套进单个script_score里，这样即使多个should匹配，也只会触发一次脚本执行：

{
  "query": {
    "bool": {
      "must": [/* 你的must条件 */],
      "should": [
        {
          "script_score": {
            "query": {
              "bool": {
                "should": [/* 原来的多个should条件 */]
              }
            },
            "script": {
              "source": "return Integer.parseInt(doc['_id'].value);"
            }
          }
        }
      ],
      "minimum_should_match": 1
    }
  }
}

方案3：用constant_score屏蔽原始查询分数 #

如果不需要bool查询本身的分数贡献，可以用constant_score包裹bool查询，再结合function_score的replace模式，确保脚本分数是唯一的最终分数：

{
  "query": {
    "function_score": {
      "query": {
        "constant_score": {
          "filter": {
            "bool": {
              "must": [/* 你的must条件 */],
              "should": [/* 你的should条件 */],
              "minimum_should_match": 1
            }
          }
        }
      },
      "script_score": {
        "script": {
          "source": "return Integer.parseInt(doc['_id'].value);"
        }
      },
      "boost_mode": "replace"
    }
  }
}

内容的提问来源于stack exchange，提问作者Amjed Omar