本文详解 Redis Cluster 报错 JedisMovedDataException: MOVED 12867 127.0.0.1:7002 的根本原因，说明其本质是客户端未遵循集群重定向协议，并提供基于 Jedis 的正确连接与调用实践。
本文详解 redis cluster 报错 `jedismoveddataexception: moved 12867 127.0.0.1:7002` 的根本原因，说明其本质是客户端未遵循集群重定向协议，并提供基于 jedis 的正确连接与调用实践。
在 Redis Cluster 模式下，数据按哈希槽（hash slot，共 16384 个）分布式存储于多个节点，每个主节点负责一部分槽位。当客户端向错误节点发送命令（例如对 key user:1001 执行 GET），而该 key 实际归属另一个节点负责的槽位（如槽 12867），Redis 就会返回 MOVED 响应——这并非错误，而是集群的标准重定向机制。
关键误区在于：直接使用单机版 Jedis（Jedis）连接集群会触发 JedisMovedDataException，因为它不具备自动重定向能力；而 JedisCluster 是专为集群设计的客户端，内部封装了槽映射缓存、节点发现、自动重试与 MOVED/ASK 重定向逻辑。
✅ 正确做法：使用 JedisCluster 替代 Jedis
// 推荐：使用 JedisCluster（自动处理 MOVED/ASK）
Set<hostandport> nodes = new HashSet();
nodes.add(new HostAndPort("127.0.0.1", 7000));
nodes.add(new HostAndPort("127.0.0.1", 7001));
nodes.add(new HostAndPort("127.0.0.1", 7002));
// 添加其他节点（至少一个可达主节点即可）
JedisCluster jedisCluster = new JedisCluster(nodes, 2000, 2000,
10, "mypass", new GenericObjectPoolConfig());
// 自动路由到正确节点，无需关心 slot 或 IP
String value = jedisCluster.get("user:1001"); // ✅ 安全可靠</hostandport>
⚠️ 注意事项：
-
JedisCluster构造时传入的节点列表只需包含任意一个健康主节点，它会通过CLUSTER NODES自动发现整个拓扑； - 避免在生产环境使用
new Jedis("127.0.0.1", 7000)直连某节点后执行跨槽操作，否则必然抛出JedisMovedDataException； - 若需底层控制（如调试），可手动计算 key 槽位：
CRC16(key) % 16384，再查CLUSTER SLOTS确认归属节点——但日常开发中完全由JedisCluster透明处理； - 连接池配置建议启用
maxTotal和testOnBorrow，提升高并发下的稳定性。
总结：MOVED 不是故障，而是 Redis Cluster 的协作契约。选用正确的客户端（JedisCluster）、理解槽路由机制、避免直连单节点，即可彻底规避该异常。
