redis集群节点无法加入的典型报错是[err] node x.x.x.x:port is not empty，根本原因是节点残留数据、集群元数据或nodes.conf文件未清空，必须执行flushall、cluster reset并手动删除nodes.conf，再验证info keyspace为空且cluster info中cluster_state为fail、cluster_slots_assigned为0，同时确保redis.conf中cluster-enabled yes、bind正确、protected-mode no、cluster-require-full-coverage no，并重启进程。
节点无法加入集群的典型报错
最常见的是 [ERR] Node 192.168.6.200:7000 is not empty. Either the node already knows other nodes...。这个错误不是网络不通，也不是密码不对，而是 Redis 拒绝“带脏数据”或“带旧集群状态”的节点加入新集群。
必须清空的三类内容
光删 dump.rdb 或只跑 FLUSHALL 不够，以下三项必须全部清理干净：
-
FLUSHALL：清空所有数据库里的 key，但不碰集群元数据 -
CLUSTER RESET：清除节点本地保存的集群拓扑、槽位映射、节点 ID 等状态（注意：该命令需在节点运行状态下执行） - 手动删除
nodes.conf文件：这是集群配置的持久化文件，藏在 redis 工作目录下，CLUSTER RESET不会删它；残留会导致节点“以为自己还在旧集群里”
检查是否真正干净
清理后别急着 redis-cli --cluster create，先验证两件事：
执行 redis-cli -h 192.168.6.200 -p 7000 INFO keyspace，返回应为空（如 db0:keys=0,expires=0,avg_ttl=0）
执行 redis-cli -h 192.168.6.200 -p 7000 CLUSTER INFO，cluster_state 必须是 fail，且 cluster_slots_assigned 应为 0
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
如果 CLUSTER NODES 还显示其他节点，说明 nodes.conf 没删干净或 CLUSTER RESET 没生效
配置项容易被忽略的坑
即使数据和状态都清空了，节点仍可能卡在“等待握手”阶段，检查以下三项：
-
cluster-enabled yes：必须在redis.conf中显式开启，仅靠命令行参数--cluster-enabled不持久 -
bind和protected-mode no：若节点绑定了127.0.0.1或保护模式未关，其他节点无法与其建立 TCP 连接 -
cluster-require-full-coverage no：新节点加入时若集群当前槽位未全覆盖（比如刚删掉一个节点），设为no才能继续，否则create或add-node会直接失败
改完配置必须重启 Redis 进程，热重载不生效
真正麻烦的不是清理动作本身，而是清理后没验证彻底，或者配置改了却忘了重启——这两个点占了线上 80% 的“加不进集群”问题。
