Elasticsearch 集群状态变红通常意味着主分片未分配，导致部分数据不可写不可读。排查应优先使用 _cluster/allocation/explain API 定位未分配分片的具体原因，再根据错误信息修复节点或配置。

命令速用版

以下命令可直接在 Kibana Dev Tools 或通过 curl 执行，用于快速定位未分配分片原因。

1. 查看集群健康状态：
GET _cluster/health?v

2. 查找未分配分片及其原因：
GET _cat/shards?v&h=index,shard,prirep,state,unassigned.reason

3. 获取具体分片分配失败解释：
POST _cluster/allocation/explain
{
"index": "你的索引名",
"shard": 0,
"primary": true
}

为什么会这样

集群状态变红的核心原因是至少有一个主分片（Primary Shard）处于未分配（UNASSIGNED）状态。Elasticsearch 要求主分片必须在线才能提供写入服务，当节点宕机、磁盘空间触发洪水阶段水位线、或分片副本数配置超过节点承载能力时，分片分配器会拒绝分配，导致集群健康度降为红色。

分步处理

步骤 1：确认未分配分片列表
执行 _cat/shards 命令，筛选 state 为 UNASSIGNED 的行。记录对应的 index 名称和 shard 编号。如果未分配分片数量为 0 但状态仍红，检查是否有系统索引异常。

步骤 2：获取分配失败详细解释
使用 _cluster/allocation/explain API 提交步骤 1 记录的索引和分片信息。重点关注返回结果中的 current_node（当前是否在节点上）和 unassigned_info（未分配信息）字段。common_info 或 allocation_explanation 字段会直接说明失败原因，例如 "disk_threshold_decider" 表示磁盘空间不足。

步骤 3：根据错误原因执行修复
若返回 "disk_threshold_decider"，清理节点磁盘空间或调整 cluster.routing.allocation.disk.watermark 配置。若返回 "node_left"，检查节点进程是否存活或网络是否连通。若返回 "version_mismatch"，确认节点间 Elasticsearch 版本是否一致。

步骤 4：触发重新分配
修复底层问题后，Elasticsearch 通常会自动重试分配。若未自动恢复，可手动触发重试：
POST _cluster/reroute?retry_failed=true

怎么验证是否生效

执行 GET _cluster/health，确认 status 字段变为 green 或 yellow。绿色表示所有主分片和副本分片均已分配，黄色表示主分片已分配但副本未完全分配（生产环境可接受）。再次执行 GET _cat/shards?v&h=state，确认没有 UNASSIGNED 状态的主分片。尝试对受影响索引执行写入操作，确认无报错。

常见坑

1. 忽略磁盘洪水水位线：默认磁盘使用率超过 95% 会禁止分配分片。仅清理日志而不调整水位线配置可能导致问题复发。

2. 强制分配导致数据丢失：使用 _cluster/reroute 强制分配主分片（allocate_stale_primary）可能导致数据回滚到旧版本，仅在确认数据可丢弃或无其他副本时使用。

3. 版本升级不一致：滚动升级集群时，若新旧版本兼容性问题未解决，可能导致分片无法在新节点分配。升级前需查阅官方兼容性矩阵。

常见问题

红色状态还能读取数据吗？

未分配主分片对应的索引数据不可读，已分配主分片的索引数据仍可读取。集群红色状态意味着部分数据不可用，而非整个集群不可用。

可以直接强制分配分片吗？

可以但有数据丢失风险，仅建议在确认数据可丢弃时使用。强制分配 stale primary 可能导致最近写入的数据丢失，应优先尝试修复节点让自动分配生效。

磁盘空间清理后为什么状态没恢复？

可能需要手动触发重试分配。清理空间后执行 POST _cluster/reroute?retry_failed=true 命令，让分配器重新评估节点资源。

参考来源

• Elasticsearch 官方文档 - Cluster Health API：https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html
• Elasticsearch 官方文档 - Shard Allocation Explanation：https://www.elastic.co/guide/en/elasticsearch/reference/current/shard-allocation.html
• Elasticsearch 官方文档 - Disk Watermark Allocation Decider：https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-cluster.html#disk-based-shard-allocation