客户端连接池不会自动重建,必须主动触发刷新;哨兵完成+switch-master事件后,旧连接仍保留在池中,新请求可能随机打到已下线的旧主节点,引发READONLY错误。

客户端连接池不会自动重建,必须主动触发刷新。哨兵完成 +switch-master 事件后,旧连接仍保留在池中,新请求可能随机打到已下线的旧主节点,引发 READONLY You can't write against a read only replica 错误。这不是网络延迟问题,而是连接池缓存了过期拓扑。
为什么Jedis默认不感知哨兵切换
Jedis 的 JedisSentinelPool 初始化时只做一次主节点发现,后续完全依赖内部的 masterHost 和 masterPort 缓存。它不订阅 +switch-master 频道,也不轮询哨兵获取最新地址。一旦主节点变更,池中所有连接都变成“僵尸连接”——直到超时或被驱逐,但这个过程不可控且慢。
- 默认
testOnBorrow = false,借出连接前不校验可用性 -
maxWaitMillis超时后抛异常,但不会自动剔除该连接,下次还可能复用 - 即使配置了
sentinel monitor,Jedis 也仅用于初始化,不用于运行时刷新
Lettuce 的自动重连机制怎么用才有效
Lettuce 基于 Netty,原生支持事件驱动和连接自动恢复,但必须启用 StaticMasterReplicaTopologyProvider 或更推荐的 SentinelTopologyProvider,并配合正确的重试策略。关键不是“开了自动重连”,而是“重连是否基于最新哨兵视图”。
- 必须设置
ClientResources.builder().reconnectStrategy(...),否则故障转移后首次重连会卡在旧地址 -
RedisURI中的哨兵地址要写全(至少两个),避免单点哨兵失效导致无法获取新主 - 禁用
autoReconnect = false是常见错误;应设为true,并搭配RetryStrategy控制退避行为 - 连接池(如
GenericObjectPool)需配置testOnCreate = true,确保新建连接立即验证目标地址有效性
Redisson 的 Config.useSentinelServers() 有哪些隐性依赖
Redisson 表面封装友好,但底层依赖哨兵返回的 master-name 与客户端初始化时传入的一致。若哨兵配置中 sentinel monitor 的第一个参数(master name)和代码里 setMasterName() 不匹配,切换后将永远连不到新主。
- 必须确认哨兵日志中
+switch-master mymaster 10.0.1.100 6379 10.0.1.101 6379的第一个字段与代码中config.useSentinelServers().setMasterName("mymaster")完全一致(区分大小写、空格) - 密码必须分别配置:哨兵连接密码用
setPassword(),主从节点密码用setMasterPassword()和setSlavePassword(),漏一个就会认证失败 - 默认
scanInterval = 1000(毫秒),即每秒向哨兵拉一次主地址;生产建议调低至250,但需权衡哨兵负载 - 若使用 ACL,哨兵用户需有
SENTINEL权限,否则SENTINEL get-master-addr-by-name命令被拒,导致无法发现新主
真正难处理的不是切换本身,而是连接池中残留的“半死连接”——它们既没断开,又无法写入,会在几秒内持续消耗线程和超时资源。任何客户端库都无法绕过这个本质:拓扑变更 ≠ 连接失效。你得主动清理、强制重建、或让连接自己快速死亡。忽略这点,再好的哨兵配置也扛不住高并发下的瞬间洪峰。


















