Redis 集群连接报错 MOVED 8902 是什么意思如何处理

Redis 集群报错 MOVED 8902 表示客户端请求的键值对所在的哈希槽 8902 不在当前连接节点上，服务端指引客户端重定向到负责该槽的正确节点。处理方法是命令行工具添加 `-c` 参数，或代码中使用支持 Cluster 协议的客户端库自动处理重定向。

先说结论：MOVED 错误是 Redis 集群正常的路由提示而非故障，表明当前节点不负责该 Key 的槽位。

命令速用版

命令行工具连接集群时必须显式开启集群模式，否则无法自动跟随 MOVED 重定向。

redis-cli -c -h 192.168.1.101 -p 6371

代码客户端需初始化 Cluster 模式，例如 Python redis-py 需使用 RedisCluster 类而非 StrictRedis。

MOVED 错误本质是协议级的路由提示，表示当前连接节点不负责该 Key 对应的哈希槽。

Redis 集群将数据分为 16384 个槽，每个 Key 通过 CRC16 算法映射到特定槽位。当客户端向错误节点发送请求时，节点计算槽位发现不属于自己，便返回 MOVED 错误及正确节点地址。这通常发生在客户端以单机模式连接集群、集群拓扑变更后客户端缓存未更新、或直连了从节点等场景。

步骤 1：检查客户端连接参数

如果是 redis-cli 工具，确认命令包含 `-c` 参数。缺少该参数时，工具不会自动重定向，直接报错。

步骤 2：检查代码客户端配置

确认代码使用的客户端库支持 Cluster 协议。例如 Java Jedis、Go go-redis、Python redis-py 集群版。普通单机客户端无法解析 MOVED 响应，需更换为集群客户端或手动实现重定向逻辑。

步骤 3：检查服务端集群配置

登录节点检查 redis.conf 配置文件，确保所有节点均设置 `cluster-enabled yes`。若某节点配置为单机模式，会导致拓扑撕裂，无法正确返回或处理重定向。

执行相同的 Key 读写命令，观察是否不再返回 MOVED 错误。使用 `CLUSTER SLOTS` 命令查看槽位分布，确认报错中提到的槽位（如 8902）是否已映射到错误信息中提供的 IP 和端口。

1. 代理层隐藏错误：若中间有 Twemproxy 或云厂商 Proxy，可能拦截 MOVED 响应，导致客户端无法触发路由刷新。

2. 静态节点列表：客户端初始化时只配置一个节点地址，若该节点宕机或槽位迁移，可能导致首次获取拓扑失败。

3. 手动重试不更新路由：捕获错误后仅重试请求而不更新本地槽位映射表，会导致后续请求持续打偏。

不代表故障，这是集群正常工作的路由机制，提示客户端去找正确的节点。

可能目标节点不可达、密码认证失败或集群状态异常，需检查网络连通性和节点状态。

使用专业集群客户端库通常不需要，它们会自动处理；自研客户端需实现解析错误并更新路由表的逻辑。