thinkphp缓存驱动连接超时表现为cache::get()返回null、页面卡顿或日志无报错，实为静默降级为file驱动；需依次验证：default是否小写'redis'、stores.redis是否完整（host/port/select缺一不可，select必须整数）、php -m | grep redis确认扩展启用、redis-cli ping验证服务连通性，并显式配置timeout和password。
ThinkPHP缓存驱动连接超时表现为Cache::get()返回null、页面加载卡顿或日志中反复出现Connection timed out，但错误不报在框架层，而是静默降级为file驱动或直接阻塞在连接建立阶段。
确认缓存驱动是否真正启用
先查config/cache.php里的'default' => 'redis'是不是小写字符串，不是'Redis'也不是'redis://'；再看'stores'数组里有没有完整的redis配置块——缺了host、port、select任意一项，TP6就会自动回退到file驱动，连超时都不会触发。
运行php -r "var_dump(cache('test_probe', 'alive', 10));"和php -r "var_dump(cache('test_probe'));"，两次都返回'alive'才算通；如果第二次是null，说明根本没连上Redis，还在用runtime/cache/下的文件缓存。
【select必须是整数，写成'0'或""会静默失败】
验证PHP扩展与网络连通性
方法一：终端执行php -m | grep redis，没输出就说明扩展没加载；Windows用户打开phpinfo()页面搜“redis”模块是否存在。
方法二：用redis-cli -h 127.0.0.1 -p 6379 -a your_password ping，能返回PONG说明服务端通、密码对、DB可访问；如果连不上，别急着调TP配置，先排查Docker容器的host设置、云服务器安全组是否放行6379端口、Redis是否绑定了127.0.0.1而没开bind 0.0.0.0。
方法三：在控制器里加一行php -r "new Redis(); echo 'class exists';"，报Class 'Redis' not found就证明PHP环境缺失扩展，和ThinkPHP配置无关。
检查连接超时参数是否生效
第一步：打开config/cache.php，在stores.redis配置项里显式加上'timeout' => 2（单位秒），这个值控制Socket连接建立超时，不设默认用PHP系统级default_socket_timeout（通常60秒）。
第二步：如果用了Redis密码，确认'password' => ''是空字符串而非省略或null，否则某些版本redis扩展会拒绝连接并卡住。
第三步：禁用持久连接，删掉或注释掉'persistent' => true这一行——PHP-FPM下开启它反而会导致连接泄漏，空闲连接被Redis主动断开后，下次复用直接报Connection refused。
注意：timeout只管建连，不管命令执行；若你看到的是“read error on connection”，那是命令响应超时，得调'read_timeout'而非'timeout'。
开启缓存调试日志定位真实问题
在config/log.php的channels里新增cache通道：
'cache' => ['type' => 'File', 'path' => runtime_path('log/cache/')],
再在config/cache.php里指定'logger' => 'cache'，否则所有缓存操作都不记日志。
确保runtime/log/cache/目录存在且web服务器进程有写权限，否则日志直接丢弃。
触发一次Cache::get('test')后，去runtime/log/cache/里搜“connect”，如果日志里根本没有这条记录，说明缓存驱动压根没加载成功，问题出在前三个环节。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
