Python操作Elasticsearch自定义映射索引未生效排查

核心根因 #

• 创建索引的请求体结构不符合ES版本规范
  ES 7.0及之后的版本废弃了索引类型（type）的概念，创建索引时指定映射的请求体键名是mappings（复数），而非你代码里写的错误单数键名mapping。ES无法识别这个错误键名，会直接忽略传入的映射配置，等于创建了一个无预设映射的空索引。
• ES动态映射自动接管了字段创建
  因为创建索引时预设映射未生效，后续传入JSON文档时，ES默认开启动态映射机制，会自动把文档的顶级根字段FullStudiesResponse识别成对象类型字段，生成自动映射，最终校验时只能看到这个根字段，和预设映射完全不符。

另外有个细节坑：代码里传入的端口参数写为b'9200'字节类型，Python客户端会将其解析为无效值，部分版本下可能导致连接异常，建议直接传整数类型的9200。

修正步骤 #

1. 修正索引创建的请求体结构 #

删掉之前错误构造的映射外层，替换为ES可识别的标准格式：

def getMappings():
    with open('/home/mapping.json') as f:
        return json.load(f)

# 标准的映射请求体结构
mapping_body = {
    "mappings": {
        "properties": getMappings()
    }
}
# 客户端连接配置修正
es = Elasticsearch([{"host": "127.0.0.1", "port": 9200}])
# 先删除之前创建错误的旧索引
es.indices.delete(index="my-index", ignore=[400, 404])
# 用正确的结构创建新索引
es.indices.create(index="my-index", body=mapping_body, ignore=400)

2. 适配文档嵌套结构的映射 #

因为待索引的JSON文档顶级根字段是FullStudiesResponse，如果你本地的mapping.json原本是直接写的根字段下的子字段定义，需要把子字段映射嵌套到FullStudiesResponse的对象定义下，示例结构：

// 调整后的 mapping.json 结构
{
  "FullStudiesResponse": {
    "properties": {
      "NStudiesAvail": { "type": "integer" },
      "Studies": { "type": "object" }
      // 其余你预设的子字段映射全部放在这个层级下
    }
  }
}

这样ES才能正确识别嵌套层级下的字段类型，不会把FullStudiesResponse整体当成无预设的动态对象。

3. 重新执行索引流程 #

旧的错误索引删除完成后，再运行批量索引JSON文件的代码，完成写入后再跑你原本的校验逻辑，就能看到预设的所有字段已经正确加载到映射中。

注意事项 #

• ES 不支持修改已有索引的映射结构，只要是创建时映射写错的索引，必须删除重建，不能通过后续代码修改现有映射。
• 如果不需要ES自动识别新增的未知字段，可以在映射配置顶层加上"dynamic": "strict"，避免后续写入文档时自动生成不符合预期的字段。

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