ThinkPHP Redis连接超时主因是配置未穿透至phpredis底层，必须在config/cache.php中显式设置'timeout'=>2.5和'read_timeout'=>2.5，否则默认使用60秒system timeout；同时需确认驱动启用、扩展加载、DNS绕过及连接有效性校验。
ThinkPHP Redis连接超时，90%不是Redis挂了，而是配置没穿透到phpredis底层——timeout和read_timeout必须显式写死在配置里，否则默认用系统级default_socket_timeout（常为60秒），卡住不报错。
确认缓存驱动是否真走Redis
ThinkPHP会静默降级：配置缺项、类型错、扩展未启，都会退到file驱动，根本不会触发Redis超时。
-
'default' => 'redis'必须是小写字符串，不能是'Redis'或'redis://' -
stores.redis下必须同时存在host、port、select三项；select必须是整数（如0），写成'0'或null会导致连接后SELECT失败，日志只显示AUTH failed等误导信息 - 执行
php -r "var_dump(cache('test_probe', 'alive', 10));"和php -r "var_dump(cache('test_probe'));"，两次都返回'alive'才算真正通；第二次是null，说明还在用runtime/cache/文件缓存
检查PHP Redis扩展与网络连通性
框架报错前，先确认底层能力是否存在。很多“超时”其实是连class都没加载成功。
- 运行
php -m | grep redis，无输出即扩展未启用；注意CLI和FPM的php.ini可能不同，Web环境务必查phpinfo()页面 - 用
redis-cli -h 127.0.0.1 -p 6379 -a your_password ping直连验证：能回PONG说明服务、密码、DB都OK；若连不上，优先排查Docker容器--network=host设置、云服务器安全组、Redis是否绑定了127.0.0.1而未开bind 0.0.0.0 - 执行
php -r "new Redis(); echo 'class exists';"，报Class 'Redis' not found就和ThinkPHP配置无关，纯属环境缺失
显式配置timeout和read_timeout参数
ThinkPHP的think-redis驱动不透传超时参数，它把timeout转成了default_socket_timeout，只影响DNS解析，对Redis命令级读取无效。
立即学习“PHP免费学习笔记（深入）”；
- 在
config/cache.php的stores.redis配置块中，必须加：'timeout' => 2.5（控制connect阶段）、'read_timeout' => 2.5（控制read阶段），两者都得设，且不能为0 - 若用
pconnect()，第六个参数才是readTimeout：$redis->pconnect('127.0.0.1', 6379, 2.5, '', 0, 2.5)；顺序错或省略第六位，read_timeout就失效 - 禁用
'persistent' => true：PHP-FPM下开启持久连接易导致连接泄漏，空闲连接被Redis主动断开后，下次复用直接报Connection refused
云环境DNS解析卡顿要绕开
阿里云、腾讯云Redis实例若配的是域名（如xxx.redis.rds.aliyuncs.com），DNS解析失败时，pconnect()的connectTimeout参数完全不生效，会卡满default_socket_timeout（60秒）。
- 用
time redis-cli -h your-redis-domain -p 6379 --connect-timeout 1 ping测试：若耗时远超1秒，说明DNS层拖慢，不是Redis本身问题 - 改用内网IP直连（如
10.0.1.5），绕过DNS；域名仅用于配置管理，实际连接走IP - 别信
php.ini里的redis.connect_timeout，PHP 8.0+和Swoole环境下基本不生效，必须靠connect()/pconnect()参数直控socket层
最隐蔽的坑是：连接对象isConnected() === true但ping()已失败，get()调用直接卡住或报read error on connection。每次关键操作前，必须组合判断!$redis->isConnected() || $redis->ping() !== '+PONG'，不能只依赖异常捕获。
