redis-cli --cluster create 初始化 Redis 7.0 集群需满足四个前提：所有节点 redis-server 已启动且端口就绪；各节点 redis.conf 启用 cluster-enabled yes 且 cluster-config-file 可写；节点间 TCP 全连通；密码配置一致并正确传入 -a 和 --cluster-yes。
直接用 redis-cli --cluster create 就能完成 Redis 7.0 集群初始化，但前提是 6 个节点已全部启动且配置正确；否则命令会卡住、报错或创建出不可用的“假集群”。
redis-cli --cluster create 命令必须满足的 4 个前提条件
这个命令不是“一键安装”，而是“一键初始化”。它只负责把已运行的节点组织成集群，不负责拉起进程、不校验配置、不处理网络连通性。常见失败都源于前置没做牢：
-
redis-server进程必须已在所有目标端口（如 7000–7005）上运行，且日志中无Failed to bind或Address already in use - 每个节点的
redis.conf必须启用集群模式：cluster-enabled yes，且cluster-config-file路径可写（否则启动失败静默退出） - 所有节点需能互相 TCP 连通：从任意一台机器执行
telnet 127.0.0.1 7001（或对应 IP+端口）必须成功；Docker 环境尤其注意是否在同一个自定义网络内 - 若配置了密码，
requirepass和masterauth必须一致，且redis-cli --cluster create命令末尾要加--cluster-yes和-a <password>，否则交互式确认阶段会认证失败
redis-cli --cluster create 的参数陷阱
看似简单的一条命令，几个参数选错会导致槽分配异常、主从关系错乱、甚至集群状态为 fail：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
--cluster-replicas 1表示每个主节点配 1 个从节点；6 个节点时，必须是偶数个节点才能整除（如 6 节点 → 3 主 3 从），填2就会报错Invalid number of replicas - 节点地址列表顺序无关，但必须写全所有 6 个地址（不能漏掉某个从节点的端口），否则该节点不会被纳入集群视图
- 不要加
--cluster-yes以外的额外 flag（比如--cluster-use-empty-masters），Redis 7.0 默认拒绝空 master，强行使用会导致后续CLUSTER INFO显示cluster_state:fail - 如果已有旧的
nodes-*.conf文件残留，redis-server启动时可能加载错误拓扑；建议每次重试前清空数据目录下的nodes-*.conf和appendonly.aof
验证集群是否真正可用，别只看 cluster info
cluster info 显示 cluster_state:ok 只说明元数据一致，不代表读写正常。必须实测以下三点：
- 用
redis-cli -c -h 127.0.0.1 -p 7000 -a 123456连入（-c不可少），执行SET testkey abc，再换端口连接（如-p 7001）执行GET testkey—— 若返回-> Redirected to slot...并最终拿到值，才算分片路由生效 - 检查槽分配是否均匀：
redis-cli -c -p 7000 cluster nodes | grep master | wc -l应等于主节点数；再对每个 master 执行redis-cli -p <port> cluster countkeysinslot <slot_id>抽查几个槽，确认非零 - 模拟主节点宕机：
kill -9掉一个主节点进程，等待 30 秒后，用redis-cli -p 7000 cluster nodes查看原从节点是否已升为master，且cluster_state仍为ok
最容易被忽略的是：Redis Cluster 要求客户端必须支持 -c（集群模式）和重定向逻辑。普通 redis-cli 直连单节点执行 GET 会失败，这不是集群问题，而是客户端没走集群协议。生产环境务必确认 SDK 是否启用了集群支持（如 JedisCluster、lettuce 的 RedisClusterClient）。
