cluster-config-file由redis集群节点在运行时自动写入，仅在槽分配完成、拓扑变化或重启恢复时更新，用于本地状态持久化而非手动配置。
cluster-config-file 是谁在写、什么时候写
cluster-config-file 不是 Redis 手动触发保存的配置，而是集群节点在运行时自动维护的本地文件。只要启用了集群模式（cluster-enabled yes），每个节点都会持续更新这个文件，记录自己负责哪些哈希槽、当前集群状态（如节点 ID、其他节点地址、槽分配版本号 currentEpoch 等）。
它只在以下情况被写入：
- 节点首次完成槽分配（比如执行
CLUSTER ADDSLOTS或收到其他节点的CLUSTER SETSLOT ... MIGRATING/IMPORTING） - 节点发现集群拓扑变化（如新节点加入、老节点下线、故障转移后主从切换）
- 节点重启后加载该文件恢复槽映射关系——这是它唯一“持久化”的意义
注意：cluster-config-file 不是配置源，而是运行时快照。你不能靠编辑它来修改槽分配，改了也没用，下次节点同步状态就会被覆盖。
为什么 cluster-config-file 改了不生效、甚至导致节点启动失败
常见错误是手动编辑 nodes.conf（默认名）来“调整槽位”，比如删掉某行、改个 0-5460 范围。这会导致：
- 校验失败：Redis 启动时会检查文件中所有槽是否被且仅被一个节点声明，重复或缺失都会报错
Invalid or missing node config - 版本冲突：每个节点维护自己的
configEpoch，手动改文件后该值可能低于集群共识值，节点拒绝加入集群，日志出现Node config epoch is not greater than my config epoch - 槽重叠：两个节点都声称拥有同一组槽，集群进入
fail状态，CLUSTER INFO显示cluster_state:fail
真正修改槽分配，必须走集群协议命令：CLUSTER ADDSLOTS、CLUSTER DELSLOTS、CLUSTER SETSLOT ... NODE，由节点间协商达成一致后，再统一更新各自 cluster-config-file。
16384 个槽不是靠文件定义，而是硬编码在 Redis 源码里
哈希槽总数 16384（即 214）是 Redis 集群的固定设计，写死在代码中，和 cluster-config-file 无关。你无法通过配置增大或减小这个数。
它的存在意义是平衡粒度与开销：
- 太小（如 1024）：单个节点挂掉影响太大，迁移成本高
- 太大（如 65536）：节点间心跳包携带的槽位位图（bitmap）膨胀，网络开销明显上升
所以实际使用中，你只需要关心「哪些槽落在哪个节点」，而不是“怎么生成这 16384 个槽”。计算方式始终是：slot = CRC16(key) & 16383，结果必落在 0–16383 区间内。
重启节点时 cluster-config-file 加载失败的典型表现
如果节点重启后卡在 Waiting for the cluster to join... 或日志反复打印 Failed to load cluster config，大概率是 cluster-config-file 损坏或不一致。排查顺序如下：
- 确认文件权限：Redis 进程必须有读写权限，否则无法更新，旧内容残留导致状态错乱
- 检查文件是否被截断：突然宕机可能导致
nodes.conf写到一半就中断，用tail -n 5 nodes.conf看末尾是否完整（应有end行和换行） - 比对多个节点的
configEpoch：用grep configEpoch nodes.conf查看，最大值应为当前集群纪元；若某个节点数值明显偏低，可临时删掉它的cluster-config-file，让它以干净状态重新握手加入
最稳妥的做法永远是：不碰这个文件，让 Redis 自己管。它只服务本地节点状态恢复，不是集群配置中心——集群真正的权威状态，始终在节点间实时交换的 gossip 消息里。
