ThinkPHP缓存配置失败主因是底层扩展缺失、驱动未注册或配置字段静默失效，而非重启不足；须验证php -m | grep redis输出、class_exists('thinkcachedriverRedis')为true、config/cache.php中type/host/port/select/password五字段齐全且类型正确，并用php -r直连测试ping与cache读写。
ThinkPHP缓存驱动配置失败后反复重启Web服务和PHP-FPM仍无改善，说明问题不在服务热加载环节，而是底层扩展缺失、驱动未注册或配置字段存在静默失效项——这些错误不会报错，只会让框架自动回退到file驱动，导致Cache::get()始终返回null。
确认PHP redis/memcached扩展真实生效
执行php -m | grep redis（Linux/macOS）或php --modules | findstr redis（Windows），输出必须含redis；若无，说明扩展未加载，不是重启次数问题，是根本没启用。
Linux下检查/etc/php/*/cli/php.ini和/etc/php/*/fpm/php.ini两个文件——CLI环境和Web环境的php.ini常不同，只改其中一个无效；Windows用户需确认phpinfo()页面中同时出现“redis”模块和“Loaded Configuration File”路径一致。
【extension=redis.so必须写在php.ini的[Dynamic Extensions]段之后，且不能被分号;注释掉】
立即学习“PHP免费学习笔记（深入）”；
改完两个php.ini后，分别执行sudo systemctl restart php-fpm和sudo systemctl restart nginx（或apache2），缺一不可。
验证topthink/think-redis是否真正注册驱动
运行php -r "var_dump(class_exists('think\cache\driver\Redis'));"，返回bool(true)才表示驱动类已加载；若为false，说明composer包未生效。
方法一：检查vendor/topthink/think-redis/src/Provider.php是否存在，该文件会在Composer自动加载时注册服务提供者。
方法二：手动触发注册，在app/provider.php末尾添加thinkproviderThinkRedisServiceProvider::register();（适用于Swoole或自定义CLI入口）。
注意：如果项目使用了自定义容器启动逻辑（如非标准tp命令行入口），ThinkRedisServiceProvider可能未被自动调用，此时必须显式注册。
逐项核对config/cache.php中的redis配置块
第一步：确认'default' => 'redis'为全小写字符串，不是'Redis'、'REDIS'或数组键名拼写错误。
第二步：检查'stores' => ['redis' => [...]]结构完整，且以下5个字段全部存在并类型正确：
-
'type' => 'redis'（必须小写） -
'host' => '127.0.0.1'（不能是localhost，Docker内可能解析失败） -
'port' => 6379（整数，不是字符串"6379"） -
'select' => 0（整数，写成"0"会导致连接成功但读写静默失败） -
'password' => ''（即使无密码也必须显式声明为空字符串，写null或省略会触发认证拒绝）
第三步：临时删掉'prefix' => 'think:'这一行，避免redis-cli无法直接查key造成误判。
【stores.redis下任意一个字段缺失或类型错误，ThinkPHP都会静默fallback到file驱动，不报任何异常】
用命令行绕过框架直连Redis验证链路
执行redis-cli -h 127.0.0.1 -p 6379 ping，返回PONG说明服务可达；若超时，检查Docker容器network mode、云服务器安全组是否放行6379端口、Redis是否绑定了127.0.0.1而非0.0.0.0。
接着运行php -r "$r = new Redis(); $r->connect('127.0.0.1', 6379); var_dump($r->ping());"，输出string(4) "PONG"表示PHP扩展能通；若报Class 'Redis' not found，说明扩展根本没加载，此时改配置毫无意义。
最后执行php -r "cache('test_key', 'test_value', 10); var_dump(cache('test_key'));"，两次输出均为string(12) "test_value"才算真正打通。
