Redis哨兵模式下客户端如何实现自动切换IP？-Redis-PHP中文网

php redis扩展不支持哨兵自动发现，因其不解析哨兵协议、不监听或轮询哨兵命令；必须手动调用sentinel get-master-addr-by-name获取主节点地址并动态重连，同时注意网络可达性、哨兵认证及缓存ttl等关键细节。

redis哨兵模式下客户端如何实现自动切换ip？

PHP 客户端无法自动感知哨兵切换后的主节点 IP，必须自己实现重连逻辑，不能只靠配置文件或连接池“自动生效”。

为什么 Redis 扩展原生不支持哨兵自动发现

PHP 的 Redis 扩展（包括 phpredis 和 redis PECL 扩展）本身不解析哨兵协议，也不监听 sentinel 频道或轮询 sentinel get-master-addr-by-name。它只做 TCP 连接，一旦连接建立，就固定用那个 IP:port，哪怕主节点已切换、旧 IP 已下线，也不会主动刷新。

常见错误现象：

主节点宕机后哨兵完成切换，但 PHP 仍持续向旧 IP 发起连接，报 Connection refused 或超时
使用连接池（如 Predis + Sentinel）却没启用 retry_strategy 或未正确配置 service_name，导致复用失效连接
把哨兵地址当 Redis 地址直连，结果调用 set() 报错：ERR This instance has no master

PHP 实现自动切换的关键步骤

核心思路是：每次操作前，先通过哨兵查当前主节点地址，再建立或复用对应连接。不能缓存 IP 长期复用，必须每次/定期刷新。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

用 Redis 扩展连接任意一个哨兵（host + port=26379），调用 rawcommand("sentinel", "get-master-addr-by-name", $masterName) 获取当前主节点 IP 和 port
拿到结果后，用新地址新建 Redis 实例；不要复用旧连接，旧连接可能已断开或指向从库
建议封装成单例类，内部维护一个 $_masterAddr 缓存，但设置短 TTL（比如 5 秒），避免频繁查哨兵，又不至于过期太久
必须捕获连接失败异常（如 RedisException），触发重试逻辑：重新查哨兵 → 获取新地址 → 重连

示例关键片段：

$sentinel = new Redis();
$sentinel->connect('127.0.0.1', 26379);
$addr = $sentinel->rawcommand("sentinel", "get-master-addr-by-name", "mymaster");
// 返回类似 ['192.168.1.106', '6379']
$redis = new Redis();
$redis->connect($addr[0], $addr[1]); // 动态地址