redis.newclusterclient 是 go 连接 redis cluster 的唯一推荐且必须使用的入口，因其支持自动 slot 路由、拓扑发现与重定向处理；而 redis.newclient 不解析 moved/ask 响应，无法适配集群协议。
redis.NewClusterClient 是 Go 连接 Redis Cluster 的唯一推荐入口，不是“可选方案”，而是集群模式下必须使用的构造方式。直接用 redis.NewClient 连单节点地址去碰 Cluster，会报 MOVED 或 ASK 错误且无法自动重试——这不是配置问题，是协议层面不兼容。
为什么不能用 NewClient 连 Redis Cluster
Redis Cluster 使用客户端重定向（MOVED/ASK）而非代理转发，redis.NewClient 完全不解析这类响应，也不维护 slot 到节点的映射表。它把 Cluster 当成普通单节点对待，每次请求都发给初始地址，失败后直接返回错误，不会尝试重定向或刷新拓扑。
真正能自动发现节点、刷新 slot 分配、处理重定向的，只有 redis.NewClusterClient 及其内部实现的 clusterClient 结构体。
-
redis.NewClient适用于单机、Sentinel（需redis.NewFailoverClient）、或明确知道只读/写固定节点的场景 -
redis.NewClusterClient是唯一支持自动 slot 路由、节点健康探测、拓扑变更感知的 client 类型 - 即使你只提供一个地址（如
[]string{"127.0.0.1:7000"}），NewClusterClient也会主动向该节点执行CLUSTER SLOTS获取全部分片信息
ClusterOptions 必填项和易错参数
Addrs 是唯一必填字段，但它的值不是“随便填一个在线节点就行”——它必须包含至少一个当前可达的 cluster node 地址，且该节点需已加入集群并完成握手。常见错误是填了已下线节点或未执行 CLUSTER MEET 的孤立实例。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
Addrs：类型为[]string，建议填 3 个以上节点地址（如["node1:7000", "node2:7000", "node3:7000"]），提升初始拓扑发现成功率 -
Password：若集群启用了密码（requirepass），必须显式设置；空字符串""和未设置效果不同——未设置会跳过 AUTH，空字符串会发 AUTH 命令并因无密码而失败 -
MaxRedirects：默认为 -1（无限重试），生产环境建议设为 16（避免环形重定向），低于 8 可能导致 MOVED 后无法到达目标节点 -
ReadOnly：设为true时所有读请求路由到 slave，但需确保集群启用了cluster-require-full-coverage no，否则部分 slot 不可用时会直接报错
连接后必须验证拓扑是否加载成功
创建 redis.ClusterClient 实例不等于连接就绪。client 初始化时会异步刷新 slot 映射，首次调用命令可能因拓扑未就绪而超时或失败。不能依赖 client.Ping(ctx).Err() 判断可用性——它只测连通性，不校验 slot 表。
- 正确做法是调用
client.ForEachShard(ctx, func(shard *redis.Client) error { return shard.Ping(ctx).Err() })，逐个检测每个分片的主节点 - 或者用
client.ClusterNodes(ctx).Val()拿到完整节点列表，检查状态是否含master且connected - 若发现
redis.Nil或"LOADING Redis is loading the dataset in memory"，说明集群正在恢复或拓扑未同步，需等待或告警
高可用的关键不在连接，而在请求生命周期管理
Cluster 客户端本身具备故障转移能力，但业务代码若忽略 context 和错误分类，照样会雪崩。比如对 redis.Nil 不做区分、用 context.Background() 处理用户请求、未设置合理超时，都会让高可用设计失效。
- 所有命令必须传带 deadline 的
context.Context，例如ctx, cancel := context.WithTimeout(r.Context(), 500*time.Millisecond) - 读操作遇到
redis.Nil是正常业务逻辑，不是错误；而redis.Timeout或redis.PoolTimeout才需要熔断或降级 - 写操作失败时，不要简单重试——
MOVED重定向由 client 自动处理，但网络中断或节点永久宕机需触发上游告警，而不是静默重试 3 次 - 关闭 client 时调用
client.Close()，它会逐个关闭内部所有 shard client，不关会导致 goroutine 泄漏
