必须使用 redis.newclusterclient 而非 redis.newclient 连接 redis cluster，因后者不支持槽位路由、节点发现与重定向，会导致 moved/ask 错误；前者自动拉取 cluster slots、处理重试与故障转移，并需正确配置密码、连接池及初始化 ping 校验。
用 redis.NewClusterClient 而不是 redis.NewClient
直接拿单节点客户端连 Redis Cluster，90% 的请求会卡在 MOVED 或 ASK 错误上，然后 panic 或无限阻塞。因为 redis.NewClient 完全不处理槽位路由、节点发现和重定向——它只认一个地址，而 Cluster 是靠客户端自己查 slot 映射表来决定往哪个节点发命令的。
必须用 redis.NewClusterClient 初始化，它内置了拓扑拉取、自动重试、故障转移感知。传进去的 Addrs 只需 2–3 个可通节点（比如 []string{"192.168.1.100:6379", "192.168.1.101:6379"}），启动后会主动 CLUSTER SLOTS 拉全量槽位分布。
别填 Password 和 DB 字段，认证和数据库号要按集群规则设
Redis Cluster 不支持 SELECT DB 命令，所有 key 都落在 0 号数据库；填了 DB: 1 会被忽略，但可能误导调试。
密码认证取决于 Redis 版本：
- Redis 6+：用
Username+Password（如default用户） - 旧版 Redis：只设
Password，且必须所有节点配同一密码
Ping 就会失败，但错误信息常是模糊的 NOAUTH Authentication required，而不是明确指出哪个节点没配。连接池参数不能依赖默认值，每个节点独立维护池
PoolSize 默认是 10，但这不是全局 10 条连接，而是“每个已知节点都开 10 条”——5 节点集群就是 50 条连接。QPS 上千时容易触发 redis: connection pool timeout。
关键参数要显式调：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
-
MinIdleConns设为 5：确保每个节点始终有空闲连接，避免首请求建连延迟 -
MaxConnAge设为30 * time.Minute：强制定期重建连接，避开 NAT 超时或防火墙静默断连导致的write: broken pipe -
PoolSize按公式算：预估 QPS × 2 ÷ 节点数（例：500 QPS / 5 节点 → 设 200），但单节点池上限别超 200，否则可能打爆 Redis 的maxclients
初始化后立刻 rdb.Ping(ctx).Err()，别等第一次 Get 才暴露问题
集群地址错、密码错、网络不通、槽位未分配……这些都在连接建立阶段就确定了，但 redis.NewClusterClient 构造函数不校验，它只是返回 client 实例。
必须在初始化完成后，用带超时的 context 主动调一次 rdb.Ping(ctx).Err()，比如：ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)if err := rdb.Ping(ctx).Err(); err != nil { log.Fatal("cluster init failed:", err) }
否则第一个业务请求才会报错，日志里看到的是 redis: MOVED 或 context deadline exceeded，排查路径绕远。
真正麻烦的不是写法，是槽位映射缓存过期后节点下线又上线的瞬态一致性；这个阶段 redis.NewClusterClient 会自动刷新，但如果你手动清了本地 DNS 缓存或改了节点 IP，就得靠 MaxConnAge 和重试机制兜底——别指望它永远“刚上线就完美”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
