Redis集群连接失败需先确认服务端启用cluster-enabled yes且至少3个主节点;客户端必须用redis-cli -c或集群驱动,否则报MOVED错误;KEYS*等跨slot命令不支持,SCAN需遍历各节点执行。

用 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清理残留状态,否则后续操作全被拒

















