必须为每个Redis集群实例单独指定唯一的cluster-config-file路径，如按端口命名nodes.conf，避免共用导致覆盖写入、握手失败和状态混乱。
cluster-config-file 必须每个实例单独指定
Redis 集群启动后会自动生成并持续更新 cluster-config-file，里面存着节点 ID、槽分配、其他节点地址等运行时状态。如果多个实例共用同一个文件（比如都默认用 nodes.conf），它们会互相覆盖写入，导致节点握手失败、集群状态混乱、甚至数据不可达。
实操上必须显式为每个实例指定不同的文件路径：
- 在每个实例的配置文件中设置
cluster-config-file /var/lib/redis/6380/nodes.conf（对应端口 6380） - 绝对路径更安全，避免工作目录不一致引发的意外同名
- 路径需确保 Redis 进程有读写权限，否则启动直接报错：
Failed to open the cluster config file
用端口号或实例 ID 命名是最稳妥的实践
人工管理多个节点时，靠“记得不一样”不可靠。命名规则要机械可推导，避免手误。
推荐方式：
- 按端口：如
cluster-config-file /data/redis/6379/nodes.conf、/data/redis/6380/nodes.conf - 按实例 ID（若用 systemd 管理）：如
cluster-config-file /data/redis/node-a/nodes.conf，配合InstanceName=node-a配置 - 禁止使用相对路径或无区分度的名字，例如
nodes.conf、cluster.conf、conf
容器或编排环境里容易漏掉这个配置
Docker 或 Kubernetes 中，常因挂载卷或配置模板复用，导致多个容器映射到同一 cluster-config-file 路径（尤其是 hostPath 或 emptyDir 未隔离时）。
检查点：
- Docker run 时用
-v /host/path/6380:/data，并在配置里写死cluster-config-file /data/nodes.conf - K8s StatefulSet 中，确保每个 Pod 的
volumeMounts指向唯一子路径，如/data/redis-0/ - ConfigMap 模板里不能硬编码固定文件名，要用环境变量或 downward API 注入实例标识
重启前务必确认文件未被其他进程占用
集群节点异常退出后，残留的 nodes.conf 可能被锁住或内容损坏；若新实例尝试写入同一文件，会出现奇怪的握手超时或 CLUSTERDOWN 报错，但日志里未必提示文件冲突。
排查建议：
- 启动前执行
lsof /path/to/nodes.conf，确认无其他 redis-server 进程持有该文件 - 检查文件修改时间是否异常新（说明刚被别的实例覆盖过）
- 临时加个校验：启动脚本里先
grep -q 'myself,' /path/to/nodes.conf，命中则报错退出——说明这文件已被其他节点用过
cluster-config-file 的依赖是隐式的、强状态的，它不像普通配置只读一次。只要两个实例指向同一个文件，无论先后启动，迟早出问题，而且症状分散，不容易一眼定位到根源。 
