Redis在线状态同步必须用redis.NewClusterClient()并正确配置Addrs、Password、Dialer,key需用{}强制slot分组,心跳应采用SET EX XX+时间戳校验,避免NX误丢、SCAN漏扫及CROSSSLOT错误。

直接用 SET 写在线状态,高并发下会丢心跳、误判离线;不加 slot 分组,集群里 key 路由错乱,SCAN 扫不到、MGET 报 CROSSSLOT;用单机 client 连集群,命令发错节点,静默失败——这些不是配置问题,是架构级误用。
为什么 redis.NewClient() 不能用于在线状态同步
在线状态本质是「高频写 + 低延迟读 + 批量扫描」,而 redis.NewClient() 是单点连接。它不会解析 MOVED 重定向,所有命令硬打到初始化填的地址上:
- 若该节点不负责
user:123:online所在 slot,返回MOVED 12345 10.0.1.5:6379,但 client 不处理,Set()直接报错,状态根本没写进去 - 后续
Get()还往原节点发,查不到值,判定“离线”,但其实用户一直在线 - 更隐蔽的是:心跳写入分散在多个节点,你用
SCAN想扫出所有在线用户,只能扫当前节点,漏掉 80%+ 的 key
redis.NewClusterClient() 初始化必须配对三项
集群 client 不是开箱即用,少配一项就可能让心跳失效:
-
Addrs至少填一个能响应CLUSTER SLOTS的节点(格式必须是"host:port",不能带redis://) -
Password必须和集群所有节点一致(Redis Cluster 要求密码全局统一) -
Dialer必须设超时,首次拓扑拉取可能耗时 >1s,建议用net.DialTimeout(network, addr, 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 必须用 {} 强制 slot 分组
Redis Cluster 按 CRC16(key) % 16384 算 slot。不加括号,user:123:online 和 user:456:online 极大概率落在不同节点:
- 心跳更新无法聚合,
MGET user:123:online user:456:online触发CROSSSLOT错误 -
SCAN只作用于单节点,运维查“当前在线人数”得连所有节点手动汇总 - 正确写法是
user:{123}:online,这样所有 123 相关 key 都落在同一 slot,支持批量操作和统一扫描
别用 KEYS user:*:online——线上禁用,O(N) 扫描会阻塞整个节点。
心跳写入要用 SET EX XX + 时间戳校验,别碰 NX
SET key val EX 30 NX 在多实例场景下几乎必然失败:多个服务同时写同一个 key,只有第一个成功,其余全被拒绝,心跳直接丢失。
- 改用
SET key val EX 30 XX(仅更新已存在 key),但 value 必须存unix timestamp:instance_id,例如"1717025488:svc-a-7f3d" - 客户端写入前先
GET当前值,解析时间戳,只在本地时间比 Redis 记录时间晚 ≥1 秒时才重设——防止单点时钟漂移导致误覆盖 - 别依赖单次
SET成功判断存活,有效性要靠「最近 N 次写入间隔是否稳定」来综合判定
真正容易被忽略的是:心跳只是信号,不是真相。你看到的“在线”,只是最后一次心跳没超时;而真实连接是否还活着,得靠长连接层自己保活,Redis 只是快照。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











