Redis分布式集群连接方法详解

本文深入解析了Redis分布式集群对接的核心要点与常见陷阱，从服务端配置（必须启用cluster-enabled、确保至少3个主节点、正确设置节点通信）到客户端连接（强制使用-c参数或集群专用驱动以支持自动重定向），再到集群特有约束（如KEYS*禁用、SCAN需遍历各节点、统计命令仅返回局部结果），以及扩缩容操作中reshard的潜在风险与状态清理技巧，系统性揭示了Redis集群“无全局视图”这一本质特性所带来的设计权衡与运维挑战，帮助开发者避开MOVED错误、CLUSTERDOWN异常和迁移卡死等高频问题，真正掌握集群模式下的正确实践逻辑。

用 redis-cli 连不上集群？先确认是否启用了集群模式

Redis 单机版默认不启用集群功能，直接用 redis-cli -h host -p port 连上去，看到的仍是单节点视图。要操作集群，必须确保服务端已启用 cluster-enabled yes，且至少有 3 个主节点（官方最低要求），否则 redis-cli 会报 CLUSTERDOWN Hash slot not served 或直接拒绝执行写命令。

• 检查配置：在 Redis 配置文件中确认存在 cluster-enabled yes、cluster-config-file nodes.conf、cluster-node-timeout 5000
• 启动方式必须是 redis-server /path/to/redis.conf，不能用 redis-server --port 7000 这类命令行参数绕过配置
• 集群节点间必须能互相通过 cluster meet 发现，防火墙需放行节点通信端口（通常是服务端口 + 10000，如 7000 → 17000）

客户端连集群不能只填一个地址——要用 -c 参数或支持集群的驱动

普通 redis-cli 默认走直连，对 SET key value 这类命令不做重定向；集群模式下，key 落在哪个 slot、由哪个节点负责，客户端得自己算或靠服务端重定向。不加 -c 就连集群，会遇到 MOVED 12345 127.0.0.1:7001 错误，然后卡住不动。

• 命令行临时测试：用 redis-cli -c -h 127.0.0.1 -p 7000，此时它会自动跟随 MOVED 和 ASK 重定向
• 代码里别手写连接单个节点：Python 用 redis.RedisCluster（不是 redis.Redis），Java 用 JedisCluster（不是 Jedis），Node.js 用 ioredis.Cluster
• 初始化时传入的节点列表只是“起点”，不是全部节点；客户端会自动拉取 CLUSTER NODES 获取完整拓扑，所以列表里写一个活着的节点就够了

KEYS * 在集群里直接报错？因为没法跨 slot 扫描

Redis 集群把数据按 slot 拆到不同节点，KEYS * 这种全量扫描命令无法在集群模式下执行，客户端会收到 (error) ERR This Redis command is not supported in cluster mode。这不是配置问题，是设计限制。

• 替代方案只有两个：要么改用 SCAN + 客户端聚合（但要注意每个节点只返回自己负责 slot 的 key），要么退回到单节点做运维类操作
• SCAN 必须指定节点执行，比如用 redis-cli -c -h 127.0.0.1 -p 7000 --scan --pattern "user:*" 只扫当前连接节点的数据，想扫全量就得遍历所有主节点分别跑一遍
• 像 DBSIZE、INFO keyspace 这类统计命令，在集群里也只返回当前节点结果，没有“总和”概念

集群扩缩容时，redis-cli --cluster reshard 不是点一下就完事

reshard 看似一键，实际过程涉及 slot 迁移、key 搬运、状态同步，中间任何一步失败都可能让集群卡在 IMPORTING 或 MIGRATING 状态，导致部分 slot 不可用。

• 迁移前务必停写或切读流量，因为迁移中对目标 slot 的写请求会被阻塞或返回 TRYAGAIN
• 不要用 --cluster-yes 盲目跳过确认；尤其注意提示的 “How many slots do you want to move” 是总数，不是每个节点分多少
• 迁移完成后，运行 redis-cli --cluster check 验证 slot 分布是否均匀、节点角色是否正确（比如没有意外多出从节点被标成主节点）
• 如果迁移中断，别急着重试；先用 CLUSTER NODES 查看各节点状态，手动用 CLUSTER SETSLOT ... IMPORTING/MIGRATING/NONE 清理残留状态，否则后续操作全被拒

今天带大家了解了的相关知识，希望对你有所帮助；关于数据库的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~