用 redis.NewClusterClient() 管理长连接在线状态可行，但须避开单节点误连、key路由错乱、跨slot操作失败三类陷阱；必须正确配置Addrs、Password、Dialer，key需用{}分组确保同slot，心跳需Ping探活+带超时ctx的Set。
用 redis.NewClusterClient() 管理长连接在线状态是可行的，但必须避开单节点 client 误连集群、key 路由错乱、跨 slot 操作失败这三类高频陷阱。直接套用单机连接写法，90% 的“在线状态不更新”“心跳丢失”问题都源于此。
为什么 NewClient() 不能用于 Redis 集群在线状态管理
在线状态这类功能通常依赖 SET + EXPIRE 或 SETEX 原子写入（如 SET user:123:online "1" EX 30），再配合后台扫描过期 key。若误用 redis.NewClient() 连集群：
- 命令会固定打到初始化时填的单个节点，哪怕该节点不负责
user:123:online所在 slot，立刻返回MOVED 12345 10.0.1.5:6379 - client 不解析重定向，直接返回 error，导致 Set 操作静默失败，用户“在线”状态根本没写进去
- 后续用
GET user:123:online时，仍发给原节点，查不到值，误判为“离线”
NewClusterClient 初始化必须检查的三项配置
正确初始化才能让 key 自动落到对应 slot 节点，保障状态写入/读取一致性：
-
Addrs至少填一个**在线且可响应 CLUSTER SLOTS 的节点**，格式必须是"host:port"（不能带redis://）；多个地址更容灾，但只要有一个通，就能拉取完整拓扑 -
Password要与集群所有节点一致（Redis Cluster 要求密码全局统一） - 别漏掉
Dialer超时设置——首次拓扑发现可能耗时 >1s，net.DialTimeout(..., 3*time.Second)更稳妥
示例：
opt := &redis.ClusterOptions{
Addrs: []string{"10.0.1.1:6379", "10.0.1.2:6379"},
Password: "mypass",
Dialer: func(ctx context.Context, network, addr string) (net.Conn, error) {
return net.DialTimeout(network, addr, 3*time.Second)
},
}
client := redis.NewClusterClient(opt)
在线状态 key 必须带大括号分组，否则路由失效
Redis Cluster 对 key 的 slot 计算基于 CRC16(key) % 16384。如果 key 是 user:123:online，不同用户会被 hash 到不同 slot，导致：
- 心跳更新分散在多个节点，无法用
SCAN统一扫描（SCAN 只作用于单节点） - MGET 批量查一批用户状态时，大概率触发
CROSSSLOT错误
正确做法是用大括号强制分组：user:{123}:online。这样所有 123 相关的 key 都落在同一 slot，便于聚合操作和扫描维护。
例如：
// ✅ 正确：同用户所有状态 key 落同一 slot
client.Set(ctx, "user:{123}:online", "1", 30*time.Second)
client.Set(ctx, "user:{123}:last_heartbeat", time.Now().Unix(), 30*time.Second)
// ❌ 错误：每次 hash 结果随机，状态碎片化
client.Set(ctx, "user:123:online", "1", 30*time.Second)
长连接心跳不能只靠单次 Set，得加 Ping + 上下文超时
集群网络波动或节点临时失联时，单纯 client.Set() 可能卡住或返回 timeout error，但程序无感知。必须配合显式健康检查：
- 每次心跳前先调
client.Ping(ctx).Err()，ctx 带 500ms 超时，失败则跳过本次更新并告警 - Set 操作也必须传带超时的 ctx：
ctx, cancel := context.WithTimeout(context.Background(), 300*time.Millisecond)，避免 goroutine 泄漏 - 别复用全局
context.Background()——它永不超时，一旦集群某节点 hang 住，整个心跳协程就卡死
真正健壮的心跳逻辑，是“Ping 探活 + 带限流的 Set”，而不是无脑轮询写入。
最易被忽略的一点：集群模式下没有全局 DB 切换概念，DB 字段在 ClusterOptions 中不存在，硬设会 panic；所有 key 都在 slot 0–16383 空间内，靠分组保证业务隔离——这点和单机 Redis 完全不同，切勿凭经验硬套。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
