---
title: "Mapper 上的 PropName – 如何解决此 Elasticsearch 异常"
date: 2026-03-25
lastmod: 2026-03-25
description: "当尝试修改现有字段或添加同名但属性不同的新字段时，Elasticsearch 会报此错误。这是因为 Elasticsearch 要求字段映射保持一致性。"
tags: ["映射器", "字段映射", "映射异常"]
summary: "版本： 7.9-7.15
 简而言之，当尝试修改现有字段或添加同名但属性不同的新字段时，Elasticsearch 会发生此错误。这是不允许的，因为 Elasticsearch 要求字段映射保持一致性。要解决此问题，您可以使用新映射删除并重新创建索引，或者创建具有不同名称和所需映射的新索引。如果数据很重要，请将数据从旧索引重新索引到新索引。在索引数据之前，务必正确定义映射。
日志上下文 #  日志 “[” + propName + “] on mapper [” 类名是 FieldMapper.java。 我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：
deprecationLogger.deprecate(DeprecationCategory.MAPPINGS; propName; "Parameter [{}] is deprecated and will be removed in a future version"; propName); } if (propNode == null && parameter.acceptsNull == false) { throw new MapperParsingException("[" + propName + "] on mapper [" + name + "] of type [" + type + "] must not have a [null] value"); } parameter."
---



> **版本：** 7.9-7.15


简而言之，当尝试修改现有字段或添加同名但属性不同的新字段时，Elasticsearch 会发生此错误。这是不允许的，因为 Elasticsearch 要求字段映射保持一致性。要解决此问题，您可以使用新映射删除并重新创建索引，或者创建具有不同名称和所需映射的新索引。如果数据很重要，请将数据从旧索引重新索引到新索引。在索引数据之前，务必正确定义映射。

日志上下文
-----------

日志 "[" + propName + "] on mapper [" 类名是 [FieldMapper.java。](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/) 我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：

```java
    deprecationLogger.deprecate(DeprecationCategory.MAPPINGS; propName;
        "Parameter [{}] is deprecated and will be removed in a future version";
        propName);
    }
    if (propNode == null && parameter.acceptsNull == false) {
        throw new MapperParsingException("[" + propName + "] on mapper [" + name
            + "] of type [" + type + "] must not have a [null] value");
    }
    parameter.parse(name; parserContext; propNode);
    iterator.remove();
    }
```