thinkphp缓存驱动失效首要排查php redis扩展是否加载：运行php -m | grep redis确认，若无则检查php.ini中extension=redis是否启用、路径是否正确，并重启php-fpm与web服务器；同时核对config/cache.php中'default' => 'redis'拼写准确、大小写敏感。
ThinkPHP缓存驱动突然失效，往往不是代码改了才出问题，而是环境、配置或服务状态在你没察觉时发生了变化——比如Redis服务意外宕机、PHP扩展被自动更新禁用、Docker容器网络重连失败，或者某次sudo执行命令后runtime/cache子目录所有权变成root导致www用户无法写入。
缓存驱动根本没加载，还在用file
第一步：打开终端，运行php -m | grep redis（Linux/macOS）或php --modules（Windows），确认redis是否在输出列表里。
第二步：如果没看到redis，立刻检查php.ini——找到extension=redis这一行，确保它没被分号注释，且路径正确（Windows下应为extension=php_redis.dll）。
第三步：重启PHP-FPM和Web服务器（Nginx/Apache），【这一步常被跳过，导致CLI环境能连Redis而网页请求始终走file驱动】。
第四步：检查config/cache.php中'default' => 'redis'是否拼写准确——大小写敏感，写成'Redis'或'redis_'都会静默回退到file驱动。
Redis服务通但缓存不生效
方法一：直连验证
执行命令：php -r "print_r((new Redis())->connect('127.0.0.1', 6379) && (new Redis())->auth('your_pass'));，返回1才算真正连通。若报错，说明密码错误、DB选错（TP默认用select => 0，不是database），或Redis配置了bind 127.0.0.1但PHP却尝试连localhost（某些系统会解析为::1）。
方法二：绕过框架查真实写入
用redis-cli -a your_pass登录后执行KEYS cache_*，如果返回空，证明数据根本没写进去——不是命中率低，是存储环节已失败。
方法三：Docker场景特判
ThinkPHP容器里配置'host' => 'localhost'是错的，它连的是自己容器的127.0.0.1，不是宿主机Redis；应改为宿主机IP或Docker网络别名（如host.docker.internal），并确认端口映射正确（-p 6379:6379）。
缓存文件权限异常导致部分失效
① 观察报错日志中的路径，例如file_put_contents(/project/runtime/cache/fa/eb4ff830.php): Permission denied；
② 进入runtime/cache/目录，运行ls -la fa/，看该子目录所有者是否为root；
③ 若是root所有，而PHP-FPM以www用户运行，则www无权在fa目录下新建文件；
④ 执行chown -R www:www /project/runtime/修复所有权；
【注意：不要只chown fa目录，必须递归修正整个runtime，否则新生成的子目录仍可能由root创建】。
序列化失败引发静默崩溃
当缓存值含Closure、PDO实例、资源句柄或未实现__sleep()的自定义对象时，ThinkPHP默认serialize()会直接抛出Fatal Error，整个请求中断——你看到的可能是500页面或空白响应，而非缓存null。
临时验证：把待缓存数据先用var_dump(is_serializable($data))（PHP 8.2+）或try { serialize($data); } catch (...) { }检测；
长期解法：在Redis驱动配置中加入'serialize' => 'json'，强制用JSON序列化（舍弃资源、闭包等不可转类型，但避免崩溃）。
缓存键被哈希后找不到原key
调用Cache::get('user:123:profile')返回null，不代表没缓存——ThinkPHP 6+会对key做MD5哈希并截取前两位建子目录，实际存储路径可能是runtime/cache/6b/86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b.php。
验证方式：开启缓存日志（config/cache.php中设'logger' => 'cache'），再查runtime/log/cache/里记录的真实key；
绕过哈希：用Cache::store('redis')->get('user:123:profile')跳过框架封装，直连驱动读取原始key。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
