Redis连不上主因是配置、扩展或连接复用问题，需检查phpredis扩展是否正确加载、服务是否运行、Docker网络配置、TP缓存配置完整性、哨兵模式设置及连接后ping检测。
Redis 连不上，八成不是密码写错了，而是配置没对上、扩展没装对、或者连接复用逻辑被忽略。ThinkPHP 默认不启用 Redis，也不自带驱动，得手动配齐三件套：扩展、包、配置。
phpredis 扩展装了没？别信 phpinfo 里有 redis 就算数
运行 php -m | grep redis，必须看到 redis（不是 igbinary 或 predis）。Windows 下检查 php.ini 是否启用了 extension=php_redis.dll；Linux/macOS 看是否加载了 redis.so。重启 PHP-FPM 或 Apache 后再测，光改配置不重启等于没改。
-
new \Redis()能实例化，但调connect()报Connection refused→ 服务没起来或端口/防火墙挡了 - 报
Class 'Redis' not found→ 扩展根本没加载，不是 TP 配置问题 - 用的是 Docker？确认
redis.conf里bind包含容器网段，别只留127.0.0.1
config/cache.php 里 redis store 必须显式定义，不能只改 default
TP6/8 不会自动补全 redis 配置项，'default' => 'redis' 只是开关，真正起作用的是 'stores.redis' 下的完整数组。漏掉 host、port、select 中任意一个，都会静默 fallback 到 file 驱动——现象是“缓存没生效但也不报错”。
-
database写成字符串"0"会导致连接成功但读写失败，必须是整型0 -
password字段在 Redis 6+ ACL 模式下要换成'auth' => 'xxx'，且用户需有+@all权限 - 用
timeout控制连接等待时长，设为0表示无限等待，线上建议设2.5左右防卡死
长连接 persistent=true 是把双刃剑，开之前先看运行模式
'persistent' => true 只对 phpredis 扩展生效，Predis 不支持。开了之后每次请求复用 TCP 连接，但副作用明显：
立即学习“PHP免费学习笔记（深入）”；
- PHP-FPM 模式下，
pm.max_requests非零时进程重启不会主动 close 持久连接，Redis 端积累大量ESTABLISHED状态连接 - Swoole/Hyperf 等常驻进程框架里开
persistent，极易引发连接泄漏，此时应换连接池（如topthink/think-redis的pool配置） - 开了
persistent必须配prefix，否则多请求共用一个持久化 ID，key 互相污染
哨兵模式不是填个地址就行，host 得设为 null 才触发哨兵逻辑
直接写 'host' => '10.0.1.10:26379' 会连上哨兵节点，但后续 SET 命令失败——因为哨兵返回的是重定向响应，不是 Redis 协议数据。正确姿势是：
-
host设为null或空字符串，强制 TP 进入哨兵路径 -
sentinels必须是数组，每个元素带host和port（如['host' => '10.0.1.10', 'port' => 26379]） -
service填哨兵中注册的 master 名（如myMaster），不是 IP 或 Redis 实例名 - phpredis 版本低于
5.3.0会静默降级为主机直连，务必用php --ri redis确认版本
最常被跳过的一步：连接后没做 ping() 检测。服务端空闲断连（redis.conf 的 timeout 300）很常见，TP 不会自动重连，拿旧连接去读写必然失败。业务代码里该加的健壮性，不能指望框架兜底。
