必须使用 redis.NewClusterClient() 连接 Redis 集群，NewClient() 因不支持集群协议（无法解析 MOVED/ASK、计算 slot、拉取拓扑）必然报错；ClusterClient 初始化需正确配置 Addrs、超时参数，并遵循 key 命名规范以确保路由准确。
直接用 redis.NewClient() 连 Redis 集群，必报 MOVED 或 ASK 错误——这不是连接问题，是根本没走对客户端初始化路径。
为什么 NewClient() 连集群一定会失败
单节点客户端 redis.NewClient() 完全不识别集群协议：它不会解析 MOVED 12345 10.0.1.5:6379 响应，也不计算 key 的 CRC16 slot，更不会主动拉取 CLUSTER SLOTS 拓扑。命令发到错误节点后，直接把原始错误透传给你，panic 或返回 error 是常态。
- 现象：日志反复出现
redis: MOVED 12345 10.0.1.5:6379，或偶发connection refused（因拓扑未刷新，仍打已下线节点） - 本质：你用的是“单机协议栈”，却在跟集群服务通信
- 正确入口只有且必须是
redis.NewClusterClient()
ClusterClient 初始化必须填哪些参数
redis.NewClusterClient() 不是简单换函数名就能跑通。它依赖初始节点自动发现整个集群，但默认配置极易卡死在启动阶段。
-
Addrs至少填一个在线的集群节点地址，格式为"host:port"（不能带redis://）；多个地址可提升容灾能力 - 节点间端口必须互通：不只是客户端能连某一个节点，所有 master/slave 节点之间也得能互相通信，否则
CLUSTER SLOTS请求失败，启动直接报redis: cluster supports only redis v3.0+这类误导性错误 -
DialTimeout和PingTimeout别设太小——首次拓扑发现可能耗时 >1s，建议 ≥2s - 示例最小可用配置：
opt := &redis.ClusterOptions{
Addrs: []string{"10.0.1.1:6379", "10.0.1.2:6379"},
Password: "mypass",
DialTimeout: 3 * time.Second,
PingTimeout: 3 * time.Second,
}
client := redis.NewClusterClient(opt)
多 key 操作和 key 命名的硬约束
ClusterClient 自动路由的前提是它能从 key 中准确提取 slot。这不靠你手动算 CRC16，但非常依赖 key 的写法。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 单 key 命令（
Get、Set、HGetAll）自动路由，无需干预 - 涉及多个 key 的命令（
MGET、DEL、Pipeline中混用不同 key）要求所有 key 落在同一 slot，否则返回redis: CROSSSLOT Keys in request don't hash to the same slot - 解决方案：用大括号分组，如
"user:{1001}:profile"、"order:{8892}:items"，{ } 内内容参与 hash，外部字符串被忽略 - 无 key 命令（
INFO、TIME）默认发给第一个可用节点；广播类命令（CLIENT LIST）会并发打所有节点，Val()返回[]interface{}，需用StringSlice()或手动断言
连接池不是显式配置，而是内建行为
redis.NewClusterClient() 内部已自带连接池，不需要、也不能像单节点那样去配 PoolSize 或 MinIdleConns。它的连接管理逻辑完全不同：
- 每个已知集群节点维护独立连接池（非全局共享）
- 连接复用基于节点地址 + slot 路由结果，不是基于 key 字符串哈希
- 真正影响性能的关键参数是
MaxRedirects（默认 8）、ReadOnly（读写分离开关）、RouteByLatency（读请求按延迟分发） - 别试图复用
redis.NewClient()的连接池调优经验——集群模式下，PoolSize等字段压根不生效
最常被忽略的一点：集群健康检查不能只看 Ping() 成功与否。必须用 redis-cli -c 手动验证 cluster nodes 输出是否干净（无 fail、noaddr），否则客户端可能拿到错误拓扑并持续路由失败。
