Elasticsearch重命名嵌套对象字段时遇mapper_parsing_exception错误求助

首先得明确你当前的问题出在哪：你用_update API发送的请求，本质是在给原本是nested类型的Customer ImpactedNested字段赋值一个字符串"CustomerImpactedNested"——这和字段的映射类型完全冲突，Elasticsearch期望这个字段是嵌套对象，结果收到了一个具体的字符串值，所以才抛出了mapper_parsing_exception。

而且Elasticsearch本身没有直接的字段重命名API，要实现字段重命名，本质是完成「数据迁移+字段清理」的操作，针对nested字段的特殊性，具体步骤如下：

1. 先给新字段添加正确的嵌套映射 #

首先要确保目标新字段（比如CustomerImpactedNested）的映射和旧字段完全一致。

• 先查看旧字段的完整映射结构，确认内部属性：

  GET r_xair_signals-2020-06/_mapping/field/Customer ImpactedNested
  

• 然后给索引添加新字段的映射：

  PUT r_xair_signals-2020-06/_mapping
  {
    "properties": {
      "CustomerImpactedNested": {
        "type": "nested",
        "properties": {
          // 这里复制旧字段返回的所有内部属性，比如"email": {"type": "keyword"}等
        }
      }
    }
  }
  

2. 用_update_by_query迁移嵌套字段数据 #

因为是nested类型，不能直接简单复制，需要用Painless脚本把旧字段的嵌套对象完整迁移到新字段，同时删除旧字段：

POST r_xair_signals-2020-06/_update_by_query
{
  "script": {
    "source": "ctx._source.CustomerImpactedNested = ctx._source['Customer ImpactedNested']; ctx._source.remove('Customer ImpactedNested')",
    "lang": "painless"
  },
  "query": {
    "exists": {
      "field": "Customer ImpactedNested"
    }
  }
}

⚠️ 注意：旧字段名包含空格，必须用方括号语法ctx._source['Customer ImpactedNested']来访问，不能直接用点语法。

3. 关于你测试新名称仍报错的排查 #

你尝试用CustomerImpactedNested11111测试仍报错，大概率是这两个原因之一：

• 你还是在给旧字段Customer ImpactedNested赋值字符串，而非操作新字段；
• 新字段被Elasticsearch动态映射成了object类型，而你给它赋值了字符串（比如之前误操作导致新字段映射异常）。

可以先查看新字段的映射确认：

GET r_xair_signals-2020-06/_mapping/field/CustomerImpactedNested11111

额外注意事项 #

• 执行数据迁移前，建议先备份数据或者在测试环境验证脚本逻辑；
• 如果索引数据量较大，添加wait_for_completion=false参数让任务异步执行，然后通过返回的task ID查看进度；
• 脚本中字段名的拼写（包括空格）一定要和实际映射完全匹配，否则会导致数据丢失或脚本执行失败。

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