缓存读取返回null或空值的主因是键名不匹配或驱动未初始化；需检查prefix、命名空间、驱动配置及实际存储键名是否一致。
缓存读取返回 null 或空值的常见原因
不是缓存没写进去，而是读的时候根本没命中——最常踩的坑是缓存键名不一致或驱动未正确初始化。Cache::get() 返回 null 时，别急着查 Redis 连接，先确认是否用了默认缓存配置却没配驱动，或者手动指定了 type 却漏传 prefix 导致键名错位。
-
Cache::get('user_123')和Cache::store('redis')->get('user_123')实际访问的是不同命名空间，后者不走全局 prefix - 使用
File驱动时，cache_path目录权限不足会导致写入静默失败，读自然为空 - TP6 默认开启缓存自动前缀（
default_prefix），但手动调用think\Cache类实例时若未 setPrefix()，键名会不匹配
如何快速验证缓存驱动是否生效
别依赖日志或猜，直接用 Cache::handler() 看当前实例绑定的驱动类，再配合 Cache::getDriverName() 检查类型。如果返回 Null 或 File 但你配了 redis，说明配置没加载或被运行时覆盖。
- 在控制器里加一行：
dump(Cache::getDriverName(), Cache::handler());，输出结果比 config/cache.php 更真实 - Redis 驱动下，
Cache::handler()->getOptions()能看到 host/port/database 是否是你预期的值 - 如果
Cache::getDriverName()是File但 config 明确写了'default' => 'redis'，检查是否在中间件或命令行中调用了Cache::connect()强制切换
过期时间不生效的三种典型场景
缓存明明设了 3600 秒，却秒过期，大概率是时间戳逻辑被干扰。ThinkPHP 的 $expire 参数在不同驱动下含义不同，不是所有地方都接受“秒数”。
-
Cache::set('key', $val, 3600)在File和Redis驱动下是秒数，但在Memcached驱动下，超过 30 天会被当作绝对时间戳处理 - 使用
DateTime对象传入 expire（如new \DateTime('+1 hour')）只在部分驱动支持，File驱动会直接忽略并按 0 处理 - TP6.1+ 中，
Cache::remember()的第三个参数是int|DateTimeInterface，但底层仍会转成时间戳；若服务器时区与 PHP 设置不一致（如 docker 容器未同步宿主机时区），计算出的过期时间可能偏差极大
调试缓存键名和实际存储内容的方法
光看代码里的键名没用，得知道最终落盘或发给 Redis 的到底是什么。ThinkPHP 会自动拼接 prefix、tag、序列化方式，这些都会影响命中。
- 开启缓存 debug 模式：在
config/cache.php加'debug' => true，然后看日志里每条Cache write/read后面的完整 key - Redis 场景下，用
redis-cli --scan --pattern "*user_123*"直接搜，对比代码里写的 key 和实际存在的 key 差在哪（常见多出thinkphp:前缀或 hash 后缀） - File 驱动下，打开
runtime/cache/目录，文件名是 md5(key)，可用md5('user_123')手动算一下是否匹配
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
