thinkphp缓存配置错误会静默回退到file驱动而非报错，根源在于default与stores键名不匹配、redis扩展缺失、缓存键非法或日志未开启导致问题难以发现。
ThinkPHP缓存驱动配置错误不会抛出明显异常，而是自动 fallback 到内置 file 驱动（甚至不写入），Cache::get() 就会一直返回 null —— 你写的 redis 配置根本没生效。
default 和 stores 键名不匹配导致驱动未加载
TP6 不是“写了 'type' => 'redis' 就走 Redis”，它靠 config/cache.php 中的 default 值去 stores 数组里找对应键。一旦不一致，就静默退回到 file 驱动。
-
default写成'redis_cache'，但stores里只有'redis'→ 不匹配，fallback -
default是'Redis'（大写 R），但stores键是'redis'（小写）→ 大小写敏感，不匹配 - 删掉没用的 store 配置项，避免干扰判断；开发时可临时把
default改成'file'快速验证业务逻辑是否正常
Redis 扩展未启用或连接参数错位
Class 'Redis' not found 或 Driver [redis] not supported 都不是 TP 配置问题，而是 PHP 环境缺失扩展或未启用。
- 运行
php -m | grep redis，输出必须含redis（不是phpredis或redis.so） - Docker 环境中，PHP 容器内必须单独安装扩展，不能只靠宿主机
-
stores.redis.select必须是整数（如0），写成字符串"0"会静默失败 -
password为空也必须显式写''，否则连接可能被拒绝
缓存键非法导致 file 驱动写入失败
File 驱动直接把键名当文件路径用：Cache::set('user/name', $data) 会尝试写入 runtime/cache/user/name.php —— 目录不存在、含斜杠、空格或中文，都会静默失败。
- 键名含
/、中文、控制字符→file驱动不报错也不写 - 建议统一过滤：
preg_replace('/[^a-zA-Z0-9_]/', '', $key)或直接md5($key) - 哪怕只是开发阶段，也建议封装层加校验：
if (!ctype_alnum(str_replace(['_', '-'], '', $key))) { throw new InvalidArgumentException('Invalid cache key'); }
日志未开启掩盖了真实问题
不配 logger，缓存读写行为就不会记日志；你看到 runtime/log/ 里空空如也，不代表没操作，很可能只是没记录。
- 在
config/cache.php中添加'logger' => 'cache' - 同时在
config/log.php的channels里定义cache通道，并设'level' => ['debug', 'info'] - 日志路径（如
runtime/log/cache/）必须存在且 Web 进程可写，否则日志直接丢弃 - 开启后搜
set和get，对比你传的 key 和日志里实际使用的 key 是否一致 —— 很多“失效”其实是 key 被哈希或截断了
最麻烦的不是报错，而是所有环节都“看起来在跑”，但缓存就是不进 Redis、不写文件、也不提示你哪错了。关键要跳出代码逻辑，先确认驱动真正在用谁、连接真正在连谁、key 真正在存谁 —— 否则调三天配置，不如一行 php -r "var_dump(cache('test', 'ok', 10));" 来得实在。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
