Cache::get() 返回 null 主因是缓存驱动未生效,仍用 file 驱动;需检查 config/cache.php 中 default 是否为 'redis'、stores.redis 配置是否完整(select 必为整数、password 不能为空)、并启用 persistent 连接。

Cache::get() 为什么返回 null?先查驱动有没有真正生效
ThinkPHP 的 Cache 门面默认不自动启用 Redis 或 Memcached,它只是个接口代理。如果 Cache::get('key') 总是返回 null,甚至写入也不报错,大概率是缓存驱动压根没切过去——还是在用默认的 file 驱动,而你根本没留意 runtime/cache 目录是否可写,或者压根没生成文件。
- 检查
config/cache.php中的default是否明确设为'redis'(不是'Redis',大小写敏感) - 确认
stores.redis配置块存在且字段完整:host、port、select(注意不是database,TP6 用select)、password(空字符串也要显式写'') -
select必须是整数,写成"0"会静默失败;password为空时不能省略,否则连接可能被拒绝 - 用命令行快速验证:
php -r "var_dump(cache('test', 'ok', 10));",再php -r "var_dump(cache('test'));",两次都得有值才算通
cache() 助手函数传 0 和 null,行为天差地别
很多人以为 cache('key', $val, 0) 是“永不过期”,结果发现 key 立刻消失——因为 TP 底层把 0 当作「立即删除」语义处理,等价于 cache('key', null)。真正想存永久,必须传 null,或者干脆不传第三个参数(依赖驱动默认行为)。
-
cache('token', $val, 0)→ 写入即删,等同于清除 -
cache('token', $val, null)→ Redis 中不设 TTL,靠手动清理或内存淘汰 -
cache('token', $val)→ 使用配置里stores.redis.expire的默认值(若设了) - 生产环境慎用
null:Redis 本身不支持无限期 key,长期堆积会吃光内存;建议用大值如31536000(1 年)更可控
多项目共用 Redis 时,key 冲突怎么破?前缀不是可选项,是必选项
ThinkPHP 默认给所有缓存 key 加 think: 前缀,这看着像保护机制,但一旦你和 Node.js 服务共用一个 Redis 实例,或者调试时想用 redis-cli keys "*" 直接看数据,就会发现完全对不上号。
- 关前缀:在
stores.redis下加'prefix' => '',立刻生效 - 换前缀:设为
'prefix' => 'shop:',比关掉更安全,也方便 redis-cli 过滤:keys "shop:*" - 注意:这个
prefix只影响Cache::get()/cache()等门面调用;手动用Redis::set()写的 key 不受控制,得自己加 - 前缀为空时,若 key 含空格或控制字符(如
user:123:name),TP 不校验,Redis 虽支持,但出问题得自己兜底
高并发下 Redis 连接打满?persistent 不是可选开关,是保命配置
本地开发跑着好好的,一上生产就频繁报 Connection refused 或超时,十有八九是 PHP 每次请求都新建 Redis 连接,没释放完就被打爆了。Linux 默认单进程最多 1024 文件描述符,Redis 连接占一个,撑不了几秒并发。
- 必须开启持久连接:
'persistent' => true,让连接复用,避免反复握手开销 - 搭配
'timeout' => 3(秒)防卡死,别用默认的 0(无限等待) - 若用 Docker,确认 Redis 容器的
bind配置包含宿主机 IP 或0.0.0.0,且宿主机防火墙放行6379 -
phpredis 扩展必须装,
predis(纯 PHP 实现)在高并发下性能和稳定性明显弱于原生扩展
最常被忽略的其实是 select 字段类型和 password 的显式声明——写成字符串或留空都会导致连接成功但操作失败,错误还不报,只能靠日志或抓包定位。这种细节,配一次少 debug 三天。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











