根本原因是框架无法实例化驱动或连接失败，而非redis服务异常；需依次验证thinkcachedriver edis类是否存在、phpredis扩展是否启用、stores.redis中select必须为整数0、password必须显式写''、prefix配置影响key可见性。
ThinkPHP缓存驱动配置参数写错后，Cache::get() 会静默返回 null、Driver [redis] not supported 报错，或 redis-cli 查不到 key，根本原因是框架无法实例化驱动或连接失败，而非 Redis 服务本身异常。
先确认错误类型：是驱动未注册，还是连接失败
运行 php -r "var_dump(class_exists('think\cache\driver\Redis'));" —— 返回 false 说明 topthink/think-redis 没装或未加载；返回 true 再执行 php -r "var_dump(extension_loaded('redis'));" —— false 表示 PHP redis 扩展根本没启用。
如果两个都为 true，但 Cache::get('test') 仍返回 null，问题一定出在 config/cache.php 的 stores.redis 配置字段上，不是 .env 或 default 设置的问题。
检查 stores.redis 中的 select 和 password 是否踩坑
打开 config/cache.php，定位到 'stores' => [ 'redis' => [ ... ]] 块：
① 查 'select' => 0 是否为整数：写成 'select' => "0" 或 'select' => '0' 会导致连接成功但数据写入失败，且无任何报错；必须是纯数字 0。
② 查 'password' => '' 是否显式写出：留空、写 null 或直接删掉这一行，Redis 会拒绝认证，连接返回 false 但框架不抛异常，静默 fallback 到 file 驱动。
【password 必须显式声明，哪怕为空字符串】
验证 host、port、timeout 是否生效
方法一：用 php -r 直连测试
php -r "$r = new Redis(); var_dump($r->connect('127.0.0.1', 6379, 3));"
若返回 bool(false)，说明网络或 timeout 设置不合理；若返回 true，再加 auth 测试：php -r "$r = new Redis(); $r->connect('127.0.0.1', 6379, 3); var_dump($r->auth('your_pass'));"
方法二：临时关闭 prefix 调试
在 stores.redis 配置中加入 'prefix' => ''，然后用 redis-cli -a your_pass keys '*' 查看是否出现未带 think: 前缀的 key；没有，说明配置未生效或连接被拦截。
排查键名与序列化导致的“假失效”
Cache::get('user_123') 返回 null，不等于 key 不存在——可能是 ThinkPHP 对 key 做了哈希或截断处理。
执行 php -r "var_dump(Cache::store('redis')->get('user_123'));" 绕过框架封装逻辑，直接读取原始 key。
若这步能取到值，说明问题出在默认 store 的 key 处理机制里；此时应检查 cache.php 中是否误配了 'serialize' => 'json' 但实际存的是 serialize 格式，导致反序列化失败。
【serialize 配置必须全局一致：config/cache.php 与 runtime/cache/ 文件内容格式要匹配】
清空缓存并强制重载配置
第一步：删除 runtime/cache/ 目录下所有文件，避免旧缓存配置被自动加载缓存住。
第二步：执行 php think clear:cache —— 这个命令只清业务缓存，不清理配置缓存；真正要清的是 runtime/container/ 和 runtime/cache/ 下的 config.php 缓存文件。
第三步：重启 PHP-FPM 和 Web 服务，确保新 php.ini 和新 config/cache.php 同时生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
