如何在Golang项目中使用go-redis连接池高效访问Redis集群-Redis-PHP中文网

必须使用 redis.newclusterclient() 连接 redis 集群，newclient() 因不支持集群协议（无法解析 moved/ask、计算 slot、拉取拓扑）必然报错；clusterclient 初始化需正确配置 addrs、超时参数，并遵循 key 命名规范以确保路由准确。

如何在golang项目中使用go-redis连接池高效访问redis集群

直接用 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() 不是简单换函数名就能跑通。它依赖初始节点自动发现整个集群，但默认配置极易卡死在启动阶段。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

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 的写法。

单 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() 或手动断言