Elasticsearch创建ecommerce索引product文档类型时遇映射解析异常求助

你遇到的这个mapper_parsing_exception错误，核心原因是Elasticsearch 7.0及以上版本已经彻底移除了文档类型（Document Type）的概念，你原来在mappings下显式定义product作为文档类型的写法，在新版本ES中已经不被支持了。

为什么会报错？ #

从ES 7.x开始，官方取消了多文档类型的支持，每个索引只能拥有一个隐含的默认文档类型_doc，不再允许在mappings下自定义类型名称（比如你写的product），这就是错误提示里"Root mapping definition has unsupported parameters: [product : ...]"的直接原因。

修正后的请求代码 #

把原请求中mappings下的product层级去掉，直接将字段属性定义在mappings节点下即可：

PUT /ecommerce 
{
 "mappings": {
   "properties": {
     "name": { "type": "text" },
     "price": { "type": "double" },
     "description": { "type": "text" },
     "status": { "type": "keyword" },
     "quantity": { "type": "integer" },
     "categories": {
       "type": "nested",
       "properties": {
         "name": { "type": "text" }
       }
     },
     "tags": { "type": "keyword" }
   }
 }
}

额外优化建议 #

另外，ES 5.x之后就已经弃用了string类型，推荐使用更细分的text和keyword类型：

• text：用于需要全文检索的字段（比如商品名称、描述），会被分词器处理
• keyword：用于精确匹配、排序或聚合的字段（比如商品状态、标签），不会被分词

我在修正后的代码里把string替换成了更合适的text或keyword，这样更符合ES的最佳实践。

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