ThinkPHP 6.x 使用 Redis 哨兵需禁用 host（设为 null）、配置 sentinels 数组、指定 service 名，并确保 phpredis ≥5.3.0 或改用 Predis；环境变量应扁平化哨兵地址，避免连接池启动时超时。
Redis哨兵连接字符串怎么写才有效
ThinkPHP 6.x 默认的 redis 驱动不原生支持哨兵（Sentinel）自动发现主节点，直接填 redis://sentinel-host:26379 会连上哨兵服务但无法执行业务命令——因为哨兵返回的是重定向响应，不是 Redis 协议数据。
必须改用 Predis 或 phpredis 的哨兵适配模式，且连接配置不能是单个地址：
-
host必须设为空或null（否则 TP 会跳过哨兵逻辑） -
sentinels是必填数组，每个元素为['host' => 'x.x.x.x', 'port' => 26379] -
service填哨兵中注册的 master 名（如myMaster），不是 Redis 实例名 -
timeout建议设为2.5以上，哨兵协商有额外 RTT 开销
示例有效配置片段（config/cache.php）：
'redis' => [
'type' => 'redis',
'host' => null,
'port' => 6379,
'password' => '',
'database' => 0,
'timeout' => 2.5,
'sentinels' => [
['host' => '10.0.1.10', 'port' => 26379],
['host' => '10.0.1.11', 'port' => 26379],
['host' => '10.0.1.12', 'port' => 26379],
],
'service' => 'myMaster',
],
phpredis 和 Predis 在哨兵场景下行为差异
ThinkPHP 6 默认优先使用 phpredis 扩展（C 扩展），但它对哨兵的支持从 v5.3.0+ 才稳定；低于此版本会静默降级为主机直连，导致故障时缓存写入失败却无报错。
立即学习“PHP免费学习笔记（深入）”；
Predis（纯 PHP 实现）哨兵兼容性更好，但需手动安装并启用：
- 确认
composer require predis/predis已执行 - 在
config/cache.php中显式指定'redis' => ['type' => 'predis']（TP 不会自动 fallback） -
Predis的service参数名是replication，值为'sentinel'，且需额外传parameters数组定义service和sentinels
若用 phpredis，务必检查扩展版本：php --ri redis | grep "Version"。低于 5.3.0 就得切 Predis，别赌“好像能用”。
环境变量里如何安全注入哨兵配置
本地开发通常不用哨兵，而测试/生产环境才启用。硬编码 sentinels 数组会导致 .env 无法覆盖——TP 的 Env 类不解析嵌套数组。
正确做法是把哨兵列表扁平化为字符串，运行时再 explode 解析：
- .env 中写：
REDIS_SENTINELS=10.0.1.10:26379,10.0.1.11:26379,10.0.1.12:26379 - 在配置文件里处理：
array_map(fn($s) => ['host' => explode(':', $s)[0], 'port' => (int)explode(':', $s)[1]], explode(',', env('REDIS_SENTINELS', ''))) - 注意空格：逗号后不能有空格，否则
explode会生成带前导空格的 host，连接失败
别试图用 JSON 字符串存数组——.env 不支持换行和引号转义，极易出错。
连接池 + 哨兵组合容易触发的超时假象
开启连接池（'pool_size' => 20）后，TP 会在初始化时预建一批连接。哨兵模式下，每次新建连接都要走一次 SENTINEL GET-MASTER-ADDR-BY-NAME 流程，若网络抖动或哨兵响应慢，就会卡在 connect() 阶段，表现为「Redis 连接超时」，但实际是哨兵查询超时。
- 降低
pool_size到5~8，避免启动时集中压哨兵 - 给
timeout单独设为3.0，高于普通 Redis 的2.0 - 加一层健康检查：在
app/common.php中监听CacheInit事件，用$cache->handler()->ping()主动探活，失败则抛异常中断启动
最常被忽略的是哨兵自身的 timeout 设置——如果哨兵配置里 down-after-milliseconds 5000，但你的 PHP timeout 是 2.0，那永远等不到哨兵响应就断了，根本没机会走到故障转移逻辑。
