Elasticsearch 5.6迁移至7.10：映射结构修复求助

核心问题分析 #

你触发的MapperParsingException是因为5.6版本的多个映射参数在7.10中已被废弃或移除：

1. _parent字段：7.x彻底移除了父子文档的_parent语法，改用join字段类型实现父子关联
2. nested类型的include_in_parent/include_in_root：7.x中这两个参数已被废弃，不再支持
3. 根映射中可能存在其他过时参数（比如旧版_all相关配置）

分步修复方案 #

1. 替换_parent为join字段

原5.6中_parent的配置：

"_parent": {
  "type": "parent_type"
}

替换为7.x的join字段：

"join_field": {
  "type": "join",
  "relations": {
    "parent_type": "child_type"
  }
}

注意：子文档写入时需指定routing为父文档ID，同时在join_field中设置{"name": "child_type", "parent": "父文档ID"}来关联父子关系

2. 移除nested类型的废弃参数

原5.6中nested字段的配置：

"nested_field": {
  "type": "nested",
  "include_in_parent": true,
  "include_in_root": true,
  "properties": { ... }
}

直接删除include_in_parent和include_in_root，保留核心nested配置：

"nested_field": {
  "type": "nested",
  "properties": { ... }
}

如果需要类似原include_in_parent的扁平化查询效果，可在查询时使用inner_hits，或根据业务需求提前扁平化写入数据

3. 清理其他根级别过时参数

检查根映射中是否存在_all、_timestamp等已废弃参数，全部移除。7.x默认禁用_all字段，无需额外配置。

完整修复后的映射示例 #

假设原5.6映射如下：

{
  "mappings": {
    "child_type": {
      "_parent": {
        "type": "parent_type"
      },
      "properties": {
        "content": {
          "type": "text"
        },
        "comments": {
          "type": "nested",
          "include_in_parent": true,
          "properties": {
            "author": { "type": "keyword" },
            "text": { "type": "text" }
          }
        }
      }
    }
  }
}

修复后的7.10映射：

{
  "mappings": {
    "properties": {
      "join_field": {
        "type": "join",
        "relations": {
          "parent_type": "child_type"
        }
      },
      "content": {
        "type": "text"
      },
      "comments": {
        "type": "nested",
        "properties": {
          "author": { "type": "keyword" },
          "text": { "type": "text" }
        }
      }
    }
  }
}

注意：7.x已移除索引类型（type）概念，所有文档默认在_doc类型下，映射中无需指定具体类型名称，直接配置properties即可

额外注意事项 #

• 迁移数据时，需确保子文档的routing值与父文档ID一致，保证父子文档存储在同一分片
• 若原业务依赖include_in_parent的查询逻辑，需修改为nested查询结合inner_hits，或重新设计数据结构
• 创建索引后，可通过GET /your_index/_mapping命令验证映射是否生效

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