PHP Redis扩展不支持哨兵自动发现，因其不解析哨兵协议、不监听或轮询哨兵命令；必须手动调用sentinel get-master-addr-by-name获取主节点地址并动态重连，同时注意网络可达性、哨兵认证及缓存TTL等关键细节。
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]); // 动态地址
容易忽略的兼容性与性能坑
哨兵返回的 IP 是容器内网 IP、Docker bridge IP 或云厂商私有网络地址，PHP 应用所在机器未必能直连。这点比 VIP 方案更隐蔽。
- 若 PHP 运行在 Kubernetes Pod 中，哨兵返回的
10.x.x.x可能是宿主机或容器网络地址，需确认网络策略是否放行 - 多个哨兵地址要轮询尝试连接，不能只连第一个；某个哨兵宕机时，
_RConnect()必须跳过失败项继续试下一个 - 不要在每次
get()前都查哨兵——高频业务会压垮哨兵进程。合理使用内存缓存（如 APCu）+ TTL 控制刷新频率 - 哨兵命令
get-master-addr-by-name不带密码参数，如果哨兵启用了 auth，必须先auth，否则返回空数组
最麻烦的不是代码写法，而是网络可达性验证和故障恢复路径的完备性——哨兵返回了新 IP，不代表你的 PHP 机器真能 ping 通、telnet 通、且防火墙放行该端口。上线前必须模拟主节点宕机，全程跟踪日志里 IP 切换、重连、命令执行是否连贯。
