Go集成Redis集群须用redis.NewClusterClient()并配置多个节点地址，自动路由依赖key分组（如"user:{1001}:profile"），多key操作需同slot，统一接口封装可屏蔽单机/集群差异。
Go语言集成Redis集群，关键不在“连上”，而在“连得稳、路由准、切得灵、用得省”。直接用单节点客户端硬连集群地址，十有八九会卡在 MOVED/ASK 错误里；而裸用 ClusterClient 又容易忽略拓扑发现、多key约束和返回类型不确定性。高效封装的核心，是把集群特性的“坑”兜住，把业务逻辑的调用变干净。
必须用 ClusterClient，且初始化要带真实节点地址
不能用 redis.NewClient()，哪怕你传的是集群中某个节点的地址——它只会当单机用，遇到重定向就 panic。正确入口是 redis.NewClusterClient()，并至少提供一个可通信的集群节点地址（如 "127.0.0.1:7000"）：
-
Addrs 字段填入一个或多个节点地址（建议填3个以上提高容错），格式为
[]string{"10.0.1.10:7000", "10.0.1.11:7000", "10.0.1.12:7000"} - 所有集群节点之间端口必须互通（不只是客户端能连某一个），否则
CLUSTER SLOTS拉取失败，启动报 “cluster supports only redis v3.0+” 这类误导性错误 - 首次拓扑发现可能耗时 >1s，别设过小的 PingTimeout 或 DialTimeout（建议 ≥2s）
自动路由靠 key 结构，不是靠代码算 hash
go-redis 的 ClusterClient 内部已封装 CRC16 + slot 映射逻辑，所有命令（Get、Set、HGetAll 等）都会自动提取 key 并路由到对应节点。但有两个硬前提：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- key 建议用大括号分组，例如 "user:{1001}:profile" —— 这样 hash 只计算
{1001}部分，确保同业务数据落在同一 slot - 多 key 操作（MGET、DEL、Pipeline 中混用）要求所有 key 落在同一 slot，否则直接返回
CROSSSLOT Keys in request don't hash to the same slot - 真要批量操作跨 slot 的 key，得先按 slot 分组，再并发提交
统一抽象访问层，屏蔽单机/集群切换成本
生产环境常需兼容开发（单机）与上线（集群）两种模式。封装时应提供统一接口，内部根据配置自动选择 client 类型：
立即学习“go语言免费学习笔记（深入）”；
- 定义一个 Cache 接口，包含
Get(key string) (string, error)、Set(key string, val interface{}, ttl time.Duration) error等方法 - 实现两个结构体：
SingleRedis（包装*redis.Client）和ClusterRedis（包装*redis.ClusterClient） - 初始化时读取配置项
redis.mode = "single" | "cluster"，返回对应实现，上层业务完全无感
Do 方法返回类型不固定，要用 Result() + 类型断言
ClusterClient 的 Do() 不是简单透传，而是按命令语义动态分发：
- 单 key 命令（GET、SET）→ 路由到目标节点 → 返回该节点原始响应类型（如
*redis.StringCmd） - 无 key 命令（INFO、TIME）→ 发给第一个可用节点 → 返回其响应
- 广播命令（CLIENT LIST、CONFIG GET）→ 并行发给所有节点 → 返回
[]interface{}，需用cmd.Val().([]interface{})或cmd.StringSlice() - 安全做法：一律先调
cmd.Result()捕获 error，再根据命令文档决定如何取值，不硬写cmd.Val().(string)
