ElasticSearch function_score返回值被截断的原因及限制疑问

问题重现 #

执行以下Elasticsearch查询：

GET my-index/_search
{
  "query": {
    "function_score": {
      "query": {
            "match_all": {}
          },
          "script_score": {
            "script": "return 16777217"
          }
    }
  },
  "sort": [
    {
      "_score": {
        "order": "desc"
      }
    },
    {
      "id": {
        "order": "asc"
      }
    }
  ]
}

返回结果中sort字段的数值与预期不符：

{
        "_shard": "[my-index-00301][0]",
        "_node": "GVZQHq_NQvKlaICNo6HtCA",
        "_index": "my-index-00301",
        "_id": "1",
        "_score": 123123120,
        "_routing": "12",
        "_source": {
          "id": "1"
        },
        "sort": [
          16777216,
          "1"
        ]
}

疑问：script_score返回值16777217为何被显示为16777216？是否存在2^24的返回值限制？

原因解析 #

这一现象的核心原因是Elasticsearch内部使用单精度浮点数（float）存储和处理_score值。单精度浮点数的有效精度为24位二进制，对应十进制约7-8位有效数字。

2^24的数值为16777216，这是单精度浮点数能够精确表示的最大整数。当数值超过这个阈值后，整数之间的间隔会大于1，无法被精确存储，最终会被舍入到最近的可表示值。例如16777217无法被单精度浮点数精确编码，会被近似为16777216。

另外注意返回结果中的_score字段显示的123123120也是近似值——原script返回的是精确整数，但经过单精度浮点数转换后，大整数都会出现精度损失。

function_score返回值的限制说明 #

function_score的脚本返回值本身没有官方文档明确标注的显式数值范围限制，但由于_score最终会被转换为单精度浮点数存储和参与排序等操作，因此当返回的整数超过2^24时，必然会出现精度丢失的情况，导致实际存储和展示的是近似值。

内容的提问来源于stack exchange，提问作者Gavril Ognjanovski