---
title: "别名不存在 (aliases_not_found_exception) 错误排查与解决"
date: 2026-03-28
lastmod: 2026-03-28
description: "aliases_not_found_exception 表示引用的别名不存在，需要创建正确的别名或使用正确的别名名。"
tags: ["别名"]
summary: "为什么这个错误发生 #  aliases_not_found_exception 表示引用的别名不存在。
如何修复 #  1. 列出所有别名 #  GET /_cat/aliases?v 2. 创建别名 #  POST /_aliases { "actions": [{ "add": { "index": "<index>", "alias": "<alias_name>" } }] } 3. 使用正确的别名名 #  确保拼写正确。
预防措施 #   使用一致的别名命名  "
---


## 为什么这个错误发生

`aliases_not_found_exception` 表示引用的别名不存在。

## 如何修复

### 1. 列出所有别名
```bash
GET /_cat/aliases?v
```

### 2. 创建别名
```bash
POST /_aliases
{
  "actions": [{
    "add": {
      "index": "<index>",
      "alias": "<alias_name>"
    }
  }]
}
```

### 3. 使用正确的别名名
确保拼写正确。

### 预防措施
- 使用一致的别名命名