如何解决Elasticsearch索引迁移时stat_type字段类型转换报错问题

报错核心逻辑 #

你看到的elasticsearch.exceptions.RequestError: RequestError(400, 'illegal_argument_exception', 'mapper [stat_type] cannot be changed from type [keyword] to [text]')报错，本质是ES检测到当前索引中stat_type已存在的类型，和本次操作尝试设置的类型不匹配，ES不支持修改已有字段的类型定义。

常见触发原因 #

你预先设置的mapping没有实际生效是最高概率的原因，具体可分为以下几类：

1. 创建mapping的操作本身执行失败：比如索引名拼写错误、请求发错集群、没有对应索引的操作权限、创建时参数格式错误，你没有捕获异常误以为mapping设置成功
2. 操作顺序错误：先执行了数据写入操作，触发ES动态映射自动将stat_type设置为text，之后再发送设置stat_type为keyword的mapping请求时，就会触发该报错
3. 字段路径设置错误：如果stat_type是嵌套在对象下的字段（例如data.stat_type），你在mapping中只写了stat_type没有补全全路径，实际ES还是会对真实写入的data.stat_type触发动态映射生成text类型

排查步骤 #

• 首先执行ES查询命令确认新索引的实际mapping：

  GET /<替换为你的新索引名>/_mapping
  

  查看返回结果中stat_type（对应实际嵌套路径）的真实类型，即可确认你的预设mapping是否生效
• 如果确认mapping配置正确，排查迁移脚本的执行顺序：确认创建索引、设置mapping的操作，完全早于所有数据写入操作
• 若需要避免动态映射干扰，创建索引时可在mapping中配置"dynamic": "strict"，遇到未预先定义的字段会直接报错，避免自动生成不符合预期的字段类型

修复流程 #

如果确认预设mapping未生效，按以下顺序操作即可：

1. 删除已创建的空新索引
2. 重新创建新索引，提交完整的mapping配置
3. 再次执行_mapping查询确认配置符合预期
4. 运行Python迁移脚本写入数据

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