---
title: "无效的别名名称 (invalid_alias_name_exception) 错误排查与解决"
date: 2026-03-20
lastmod: 2026-03-20
description: "invalid_alias_name_exception 表示使用了无效的别名名称，别名不能以 _ 开头，不能包含特殊字符或空格。"
tags: ["别名", "命名规范"]
summary: "为什么这个错误发生 #  invalid_alias_name_exception 表示使用了无效的别名名称。
如何修复 #  1. 遵循命名规则 #   不能以 _ 开头 不能包含特殊字符 不能包含空格  2. 使用正确的别名 #  POST /_aliases { "actions": [{ "add": { "index": "<index>", "alias": "valid-alias-name" } }] } 预防措施 #   使用小写字母、数字和连字符  "
---


## 为什么这个错误发生

`invalid_alias_name_exception` 表示使用了无效的别名名称。

## 如何修复

### 1. 遵循命名规则
- 不能以 `_` 开头
- 不能包含特殊字符
- 不能包含空格

### 2. 使用正确的别名
```bash
POST /_aliases
{
  "actions": [{
    "add": {
      "index": "<index>",
      "alias": "valid-alias-name"
    }
  }]
}
```

### 预防措施
- 使用小写字母、数字和连字符