index is unrecoverable - 如何解决此 Elasticsearch 异常 | Easysearch | 分布式搜索引擎

适用版本： 6.8-8.9

1. 错误异常的基本描述 #

index is unrecoverable 表示 Elasticsearch 在检查某个分片或索引的本地数据后，判断其已经损坏到无法通过正常恢复流程继续使用。这个错误通常出现在人工诊断工具、损坏修复提示或恢复失败后的进一步检查阶段，含义非常直接: 当前这份本地索引数据已经不可信。

常见现象 #

某个主分片长期无法启动，相关节点日志反复出现损坏或恢复失败信息。
Elasticsearch 给出“可以分配一个新的空主分片”的提示，这意味着继续保留当前本地数据意义不大。
常伴随 Lucene 损坏、translog 损坏、校验失败或 shard 路径异常。

典型报错与异常栈 #

ElasticsearchException: Index is unrecoverable

2. 为什么会发生这个错误 #

这类错误通常不是普通的临时恢复失败，而是 Elasticsearch 已经确认本地 shard 数据损坏严重，无法继续依靠它启动索引。常见原因包括：

磁盘故障或文件系统异常导致 Lucene 段文件损坏。
非正常关机、卷损坏或底层存储抖动造成 translog 与索引文件不一致。
人工误删 shard 目录中的关键文件，导致索引结构不完整。
节点长期存在硬件或宿主机问题，累计造成数据不可恢复。

3. 如何排查和解决这个异常和解决这个异常 #

此时重点已经不是“如何保留当前坏数据”，而是“是否还有其他可恢复来源”。

先确认受影响的是主分片还是副本分片。
如果有健康副本，可优先让集群从副本重建主分片，而不是继续依赖本地坏数据。
如果没有可用副本，检查是否存在可用快照，可以从快照恢复该索引。
查看节点和系统日志，确认是否存在磁盘错误、文件系统错误或硬件告警。
如果 Elasticsearch 已明确提示只能分配新的空主分片，说明当前本地数据已无法作为恢复来源。

排查时需要注意的问题 #

不要把“unrecoverable”理解成一次普通的短时失败，它往往意味着必须接受数据丢失或改走其他数据来源恢复。
如果底层磁盘仍有问题，直接重新分配或恢复也可能再次失败。
在做空主分片分配前，要先确认是否还有快照、远端副本或其他可恢复副本可用。

4. 如何解决这个错误 #

常用修复思路 #

如果有健康副本，优先通过副本完成恢复。
如果有快照，删除坏索引或坏分片后从快照恢复。
如果既没有副本也没有快照，只能接受丢失损坏数据，按提示分配新的空主分片。
修复底层磁盘、文件系统或宿主机问题后，再让分片重新分配，避免新数据再次受损。

借助 INFINI 产品提升排障效率 #

INFINI Console 可关联节点硬件指标、磁盘状态、分片异常和恢复日志，帮助判断是否为节点级损坏。
INFINI Gateway 对底层损坏修复帮助不大，但可帮助在恢复期间控制流量冲击。

5. 小结 #

index is unrecoverable 的含义非常严厉: 当前这份索引本地数据已经不再可作为可靠恢复来源。处理时应优先寻找健康副本或快照；如果都没有，只能在确认风险后接受数据丢失并重建空分片，同时修复底层存储问题。

附：日志上下文 #

terminal.println("You can allocate a new, empty, primary shard with the following command:");
printRerouteCommand(shardPath, terminal, false);
throw new ElasticsearchException("Index is unrecoverable");

标签

索引恢复数据损坏 ElasticsearchException shard

index is unrecoverable - 如何解决此 Elasticsearch 异常