ThinkPHP 6.x 中必须将 Redis 配置的 host 显式设为 null 才能触发哨兵逻辑；若 host 为 '' 或 'localhost'，则静默降级直连导致协议错误。
ThinkPHP 6.x 中必须禁用 host 才能触发哨兵逻辑
TP 6 默认的 Redis 连接器会优先走直连模式；只要 host 不为 null 或空字符串，它就完全忽略 sentinels 和 service 配置，直接尝试连接 host:port —— 这会导致你明明配了哨兵，却连上某个哨兵节点后卡在协议错误（哨兵返回的是重定向响应，不是 Redis 命令响应）。
正确做法是显式设 'host' => null，哪怕你只填了 sentinels 数组和 service，TP 也会进入哨兵适配分支。别信“留空就行”，必须是 PHP 的 null，不是 '' 或 'localhost'。
-
host设为''或'127.0.0.1'：静默降级为主机直连，故障时无任何提示 -
port仍需保留（如6379），它会被用作 fallback 主端口，但实际不用于初始连接 -
timeout建议 ≥2.5，哨兵协商涉及多次往返，低于此值容易在启动时超时失败
Predis 是更稳妥的选择，但要手动指定驱动类型
phpredis 对哨兵的支持从 v5.3.0+ 才真正可用；低于该版本（比如很多 CentOS 7 默认装的 5.2.x）会跳过哨兵逻辑、假装连上了主节点，结果写入全部丢失且无报错。Predis 没这个问题，纯 PHP 实现，哨兵兼容性稳定，但 TP 不会自动 fallback，必须显式声明。
- 执行
composer require predis/predis安装依赖 - 在
config/cache.php的 Redis 配置中加'type' => 'predis' - Predis 的哨兵配置字段名不同：
service要写成'replication' => 'sentinel'，且需额外传'parameters' => ['service' => 'myMaster', 'sentinels' => [...]] - 别漏掉
'scheme' => 'tcp'，否则 Predis 可能误用 unix socket
环境变量无法直接存数组，必须扁平化解析
.env 文件不支持嵌套结构，直接写 REDIS_SENTINELS=[{"host":"x","port":26379}] 会被当字符串原样读取，env() 返回的是字符串，不是数组。硬编码在配置里又导致本地开发无法覆盖。
立即学习“PHP免费学习笔记（深入）”；
正确方式是把哨兵地址列表压成逗号分隔字符串，在运行时解析：
- .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', ''))) - 注意空值防御：如果
env('REDIS_SENTINELS')为空，explode(',', '')会返回['']，需加array_filter清空空项
连接池启动失败常因哨兵响应慢，别只盯 timeout
TP 启动时会预热连接池，若此时哨兵集群尚未就绪或网络延迟高，RedisSentinel::getMasterAddrByName() 可能超时，整个应用启动失败。这不是配置写错了，而是时序问题。
- 检查哨兵是否真在监听：用
redis-cli -h 10.0.1.10 -p 26379 ping确认每个哨兵可达 - 确认
service（即 master name）与哨兵配置中sentinel monitor第一个参数完全一致（大小写敏感、不能有空格） - 如果用 phpredis，运行
php --ri redis查版本；5.3.0 以下必须切 Predis，没商量余地 - 连接池初始化失败时，TP 日志里通常只报
Connection refused或空异常，得开redis.log或抓包看真实请求流向
