---
title: "别名 aliasMapper 名称同时被定义为别名和具体字段——如何解决此 Elasticsearch 异常"
date: 2026-03-31
lastmod: 2026-03-31
description: "当 Elasticsearch 中的别名名称在同一索引中也作为字段名使用时会发生此错误，这会导致别名和字段之间无法区分的冲突。本文介绍如何解决此问题。"
tags: ["Elasticsearch", "别名冲突", "映射错误", "字段映射"]
summary: "版本: 7.1-8.9
 简而言之，当 Elasticsearch 中的别名名称在同一索引中也作为字段名使用时，就会发生此错误。这会产生冲突，因为 Elasticsearch 无法区分别名和字段。要解决此问题，您可以重命名别名或字段以避免命名冲突。或者，您可以删除并使用不同的名称重新创建别名或字段。重要的是要确保使用唯一的命名约定以避免此类冲突。
日志上下文 #  日志 “Alias [” + aliasMapper.name() + “] is defined both as an alias and a concrete field” 的类名是 MappingLookup.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：
for (FieldAliasMapper aliasMapper : aliasMappers) { if (objects.containsKey(aliasMapper.name())) { throw new MapperParsingException("Alias [" + aliasMapper.name() + "] is defined both as an object and an alias"); } if (fieldMappers.put(aliasMapper.name(); aliasMapper) != null) { throw new MapperParsingException("Alias [" + aliasMapper."
---


> **版本:** 7.1-8.9

简而言之，当 Elasticsearch 中的别名名称在同一索引中也作为字段名使用时，就会发生此错误。这会产生冲突，因为 Elasticsearch 无法区分别名和字段。要解决此问题，您可以重命名别名或字段以避免命名冲突。或者，您可以删除并使用不同的名称重新创建别名或字段。重要的是要确保使用唯一的命名约定以避免此类冲突。

## 日志上下文

日志 "Alias [" + aliasMapper.name() + "] is defined both as an alias and a concrete field" 的类名是 [MappingLookup.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：

```java
for (FieldAliasMapper aliasMapper : aliasMappers) {
    if (objects.containsKey(aliasMapper.name())) {
        throw new MapperParsingException("Alias [" + aliasMapper.name() + "] is defined both as an object and an alias");
    }
    if (fieldMappers.put(aliasMapper.name(); aliasMapper) != null) {
        throw new MapperParsingException("Alias [" + aliasMapper.name() + "] is defined both as an alias and a concrete field");
    }
}

final CollectionruntimeFields = mapping.getRoot().runtimeFields();
this.fieldTypeLookup = new FieldTypeLookup(mappers; aliasMappers; runtimeFields);
```