# CLUSTERDOWN 集群已关闭 - 节点超时，副本未同步

- **ID:** `redis/cluster-node-timeout-replica`
- **领域:** redis
- **类别:** network_error
- **错误码:** `ERR`
- **验证级别:** ai_generated
- **修复率:** 82%

## 根因

集群节点超时且其副本未完全同步，导致集群失去法定人数并将自身标记为关闭。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 7.2.0 | active | — | — |
| 7.4.0 | active | — | — |
| 8.0.0 | active | — | — |

## 解决方案

1. ```
   强制副本同步：CLUSTER REPLICATE <主节点ID>。然后使用 CLUSTER INFO 等待复制完成。
   ```
2. ```
   如果主节点永久关闭，将副本提升为主节点：在副本节点上执行 CLUSTER FAILOVER FORCE。
   ```
3. ```
   增加 cluster-node-timeout 到更高值（例如 30000ms）以容忍临时网络问题：CONFIG SET cluster-node-timeout 30000。
   ```

## 无效尝试

- **** — Restarting the failed node without fixing the replica sync will cause the same timeout again because the replica is still behind. (70% 失败率)
- **** — Increasing cluster-node-timeout alone without addressing network issues or replica sync lag will not prevent future timeouts. (50% 失败率)