Root mapping definition has unsupported parameters

# 情境
今天在使用elasticsearch 7.93,在进行创建索引的时候,出现的问题


# 有问题的创建语句 (本人使用的是elasticsearch-head谷歌插件)
http://192.168.2.155:9200/
book       PUT方式
{
   "settings":{
      "number_of_shards": 5,
      "number_of_replicas": 1
   },
   "mappings":{
      "novel":{
         "properties":{
             "name":{
                "type": "text",
                "analyzer": "ik_max_word",
                "index": true,
                "store": false
             },
             "author":{
                "type": "keyword"
             },
             "count":{
                "type": "long"
             },
             "date":{
                "type": "date",
                "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
             },
             "desc":{
                "type": "text",
                "analyzer": "ik_max_word",
                "index": true,
                "store": false
             }
         }
      }
   }
}


# 问题原因
elasticsearch7之后,去掉了类型这个数据结构 (也就是novel)


# 正确如下
{
   "settings":{
      "number_of_shards": 5,
      "number_of_replicas": 1
   },
   "mappings":{
         "properties":{
             "name":{
                "type": "text",
                "analyzer": "ik_max_word",
                "index": true,
                "store": false
             },
             "author":{
                "type": "keyword"
             },
             "count":{
                "type": "long"
             },
             "date":{
                "type": "date",
                "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
             },
             "desc":{
                "type": "text",
                "analyzer": "ik_max_word",
                "index": true,
                "store": false
             }
      }
   }
}

 

### Elasticsearch 中 `mapper_parsing_exception` 异常解决方案 在 Elasticsearch 版本 7.x 及以上,由于移除了对多类型的支持,因此当尝试创建索引并指定自定义 `_type` 参数时会触发 `mapper_parsing_exception` 异常。具体表现为错误提示:“Root mapping definition has unsupported parameters”。以下是针对此问题的分析与解决办法。 #### 1. 原因分析 从 Elasticsearch 7.x 开始,默认情况下不再支持显式指定索引类型(即 `_type` 字段),默认类型的名称被设置为 `_doc`[^2]。如果仍然试图通过请求体中的映射部分传递 `_type` 或其他不支持的参数,则会导致上述异常发生。此外,在某些场景下,即使代码逻辑本身无误,也可能因为依赖库版本不同而引发类似的兼容性问题[^4]。 #### 2. 解决方案一:调整索引结构设计 对于新项目或者可以修改现有项目的开发者来说,最推荐的方式是遵循官方指南,完全去掉任何关于 `_type` 的声明。例如: ```json PUT /my-index-000001 { "mappings": { "_doc": { /* 不再需要 _doc */ "properties": { "field_name": { "type": "text" } } } } } ``` 应改为如下形式来重新构建索引及其对应的 mappings 定义文件: ```json PUT /my-new-index { "mappings": { "properties": { "field_name": { "type": "keyword" }, ... } } } ``` 这里去掉了所有的 `_type` 配置项[^3]。 #### 3. 解决方案二:启用旧版行为 (仅限于特定情况) 尽管如此,如果你确实有特殊需求必须保留这种功能的话,可以通过启动节点前编辑配置文件实现临时恢复传统模式的功能——只需简单地添加一行到 elasticsearch.yml 文件里即可完成此项更改: ```yaml include_type_name: true ``` 然而需要注意的是这种方法并不适用于未来更高版本(Elasticsearch 8+),而且强烈反对将其应用于生产环境之中^。 #### 4. 解决方案三:检查客户端工具的一致性 另外值得注意的一个方面在于开发过程中使用的各种 SDK 和 API 是否保持一致也很重要。比如有时候同样的命令序列可能在 Kibana Console 下能够成功运行但却无法经由 Java High Level REST Client 正确提交给服务器端处理;此时应当仔细核对自己所引入 jar 包清单是否存在冲突现象以及它们之间相互协作的关系是否正确设定好等等细节之处。 --- ### 总结 综上所述,面对此类 Mapper Parsing Exception 导致的问题时我们通常可以从以下几个角度出发寻找答案: - 更新应用程序以适应新的单一型别模型; - 如果必要的话可以在短期内借助 include_type_name 设置维持向后兼容能力直到彻底迁移完毕为止; - 确认整个技术栈内部组件间交互协议达成统一标准从而减少不必要的麻烦。 希望这些信息可以帮助您有效应对当前遇到的技术挑战!
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值