ElasticSearch 8.5.3：Painless脚本提示branch字段在mapping中不存在的问题排查

问题根源 #

你的branch字段是object类型，ElasticSearch中object类型本身不会生成可通过doc['branch']访问的正排索引，只有它的子字段（如branch.working_days.friday.open）会被创建索引。因此直接在脚本中调用doc['branch']会提示字段不存在。

另外你提到尝试将branch映射为array类型，这是错误操作——ElasticSearch没有array类型，所有字段默认都支持存储数组值，无需专门声明。

解决方案 #

根据你的需求场景，推荐两种可行方案：

方案1：通过_source访问原始文档数据 #

适合需要完整操作branch数组结构的场景，直接从原始文档中读取branch数据：

def branches = params._source.branch;
// 添加非空判断，避免空指针异常
if (branches != null && !branches.isEmpty()) {
    // 你的业务逻辑，示例返回1
    return 1;
} else {
    return 2;
}

对应的完整查询语句：

GET companies/_search
{
  "sort": [
    {
      "_script": {
        "type": "number",
        "script": {
          "source": """
            def branches = params._source.branch;
            if (branches != null && !branches.isEmpty()) {
              return 1;
            } else {
              return 2;
            }
          """,
          "lang": "painless"
        },
        "order": "asc"
      }
    }
  ]
}

注意：该方式性能略低，因为需要加载完整的原始文档，适合数据量不大或对性能要求不高的场景。

方案2：通过子字段的doc值间接操作 #

如果你的排序逻辑可以基于branch的子字段（比如判断是否有分支、分支数量等），可以直接访问子字段的doc值，性能更优：
比如通过子字段的长度判断branch数组的存在性：

// 取任意一个必有的branch子字段，比如working_days下的open字段
def branchCount = doc['branch.working_days.monday.open'].size();
return branchCount > 0 ? 1 : 2;

对应的查询语句：

GET companies/_search
{
  "sort": [
    {
      "_script": {
        "type": "number",
        "script": {
          "source": """
            def branchCount = doc['branch.working_days.monday.open'].size();
            return branchCount > 0 ? 1 : 2;
          """,
          "lang": "painless"
        },
        "order": "asc"
      }
    }
  ]
}

该方式利用正排索引的doc值，无需加载原始文档，性能更好。

补充说明 #

如果你的业务逻辑需要复杂的嵌套对象操作，可考虑将branch字段设置为nested类型，但这会改变索引结构和查询方式，需要重新索引数据，且排序脚本中需结合nested上下文处理，成本较高，仅推荐在必要时使用。

内容的提问来源于stack exchange，提问作者KodeFor.Me