必须使用 NewFailoverClient 连接哨兵，不能用 NewClient 直连固定地址，否则绕过哨兵失去故障转移能力；它自动连接哨兵、获取主节点、监听 +switch-master 事件并重试更新。
用 NewFailoverClient 连哨兵，不是 NewClient
哨兵模式下，**不能直接用 NewClient 连某个固定地址**——那等于绕过哨兵，失去故障转移能力。go-redis 的哨兵支持是封装在 NewFailoverClient 里的，它内部会：自动连接哨兵节点、拉取当前主节点地址、监听 +switch-master 事件、出错时自动重试并更新连接。
常见错误现象：
• 写了 NewClient(&Options{Addr: "127.0.0.1:6379"})，测试时主节点正常，一模拟宕机就报 connection refused
• 手动调用 SENTINEL GET-MASTER-ADDR-BY-NAME 拿到地址再连，但后续主从切换后客户端仍往旧地址发请求，数据写丢或读不到最新值
-
MasterName必须和哨兵配置中sentinel monitor mymaster ...的名字完全一致（区分大小写） -
SentinelAddrs填的是哨兵节点地址（默认端口26379），不是 Redis 实例地址；至少填一个，但建议写全（如[]string{"10.0.1.10:26379", "10.0.1.11:26379", "10.0.1.12:26379"}），避免单点失效 - 如果哨兵启用了认证，必须设
SentinelPassword；Redis 主从的密码（Password）是单独字段，别漏掉
FailoverOptions 里哪些字段真会影响高可用行为
这个结构体看着参数多，但真正决定“是否真的能自动切主”的就几个关键项：
-
MasterName错了，客户端连不上任何主节点，日志里会反复打印failed to resolve master -
SentinelAddrs中任一哨兵不可达，客户端会轮询尝试下一个；但如果全不可达，初始化就会失败（不会静默降级） -
ReplicaOnly: true会让所有读请求只打到从节点（适合报表类只读场景），但写操作会 panic —— 它不帮你路由写请求，你得自己判断读写分离逻辑 -
MaxRetries和MinRetryBackoff控制重连节奏；默认重试 8 次、间隔 8ms 起步，主节点恢复慢时可能来不及切回来，建议按业务容忍调整
注意：DB 字段有效，但 Username 在哨兵模式下目前仅支持 Redis 6+ 的 ACL 用户名，且需同时配 SentinelUsername（哨兵自己的用户）和 Username（Redis 实例的用户），两者不同源。
立即学习“go语言免费学习笔记（深入）”；
连接后怎么验证哨兵真的在工作
光 Ping() 成功不代表哨兵链路可靠——它可能只是连上了哨兵，还没拿到主节点，或者主节点已切但客户端没收到通知。
实操建议：
- 启动客户端后，立刻执行一次写操作（如
SET test_key sentinel_ok），再立即GET；成功说明当前主节点可写可读 - 手动 kill 当前主 Redis 进程，观察日志：应该看到类似
sentinel event: +switch-master mymaster ...的输出，且后续命令在 2–5 秒内恢复（取决于哨兵down-after-milliseconds配置） - 用
redis-cli -p 26379 SENTINEL MASTER mymaster对比哨兵视角的主节点 IP/PORT，和客户端client.Options().Addr是否一致；不一致说明监听失效或网络分区
容易踩的坑：没开 context 超时，SET 卡住十几秒才返回 error；应统一用带 timeout 的 context（如 ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)）
为什么 NewFailoverClient 初始化慢或偶发失败
这不是 bug，而是哨兵协议本身的交互成本：客户端要先连哨兵、发 SENTINEL GET-MASTER-ADDR-BY-NAME、解析响应、再连主节点、最后发 PING 校验。三步网络往返，中间任一环节延迟高就会拖慢。
- 本地开发时用
localhost，但哨兵配置里写的是内网 IP，导致解析到错误地址 → 检查哨兵配置中sentinel announce-ip是否设对 - Docker 或 Kubernetes 环境中，哨兵和 Redis 实例跨 namespace，DNS 解析慢或失败 → 改用 headless service + FQDN，或在
SentinelAddrs里直接写 Pod IP - 哨兵集群脑裂（quorum 不足），返回的主节点地址为空 → 查
SENTINEL MASTERS和SENTINEL SENTINELS mymaster确认仲裁状态
初始化阶段没有后台重试机制，失败就是失败；生产环境建议包装一层懒加载 + 重试逻辑，别让服务启动卡死在 Redis 连接上。
