File缓存文件存储在storage/framework/cache/data/目录下,为带哈希前缀和.bin后缀的二进制文件,不自动清理过期项,需手动执行cache:clear --driver=file或定期运行cache:prune-stale命令安全清理。

File缓存不会自动清理过期文件,必须手动触发或依赖系统级策略,否则 storage/framework/cache/data/ 会持续膨胀。
file驱动缓存到底存在哪?
所有通过 Cache::put()、cache()->remember() 等写入的缓存项,在使用 file 驱动时,实际落地为 storage/framework/cache/data/ 目录下的二进制文件(带哈希前缀和 .bin 后缀)。这些文件不按 TTL 删除,也不受 Laravel 请求生命周期管理——PHP 进程退出后仍长期存在。
常见错误现象:cache:clear 执行后 storage/framework/cache/data/ 里文件数量没变;改了缓存过期时间但旧文件还在;磁盘空间缓慢增长却查不到源头。
- 该目录下文件名无业务含义,无法靠命名识别归属,只能靠
Cache::get()或Cache::has()判断是否有效 -
cache:clear命令会调用FileStore::flush(),它遍历目录并删除所有文件——但仅限于当前配置的cache.stores.file.path指向路径 - 若项目中自定义了多个 file 缓存 store(如
cache.stores.local指向storage/cache/local),cache:clear默认不清理它们,除非显式加--driver=local
为什么 cache:clear 有时删不干净?
因为 cache:clear 只清「当前默认缓存 store」,而 Laravel 的 cache.default 配置可能不是 file —— 比如你设了 redis 为默认驱动,那 cache:clear 就只执行 FLUSHDB,对 storage/framework/cache/data/ 完全无感。
使用场景:本地开发用 file 驱动调试,但生产环境切到 redis;此时 cache:clear 在本地无效,在线上又误删 redis 全库。
- 确认当前默认驱动:
php artisan tinker→ 输入config('cache.default') - 强制清 file 驱动:
php artisan cache:clear --driver=file - 清多个驱动:
php artisan cache:clear --driver=file,redis(Laravel 12+ 支持) - 注意:file 驱动的
flush()不检查文件是否过期,是暴力清空整个目录,慎用于共享缓存目录
如何安全地自动清理过期 file 缓存?
File 驱动本身不提供后台 GC,得靠外部手段。直接 rm -rf storage/framework/cache/data/* 很危险:可能删掉正在被读写的临时文件,导致 Cache::get() 返回 false 或抛出异常。
推荐做法是用 Laravel 自带的 prune 机制(Laravel 9.20+)或封装安全脚本:
- 启用自动修剪:
php artisan cache:prune-stale(仅对 file 和 database 驱动生效) - 该命令扫描
storage/framework/cache/data/,比对每个文件头里的过期时间戳,只删已过期项 - 可加入定时任务:
$schedule->command('cache:prune-stale')->daily(); - 若用旧版 Laravel,需手写脚本:用
find storage/framework/cache/data/ -name "*.bin" -mmin +60 -delete(按修改时间删 60 分钟前的)——但注意这和 TTL 不一致,仅作兜底
开发阶段最容易忽略的 file 缓存残留点
Blade 视图缓存、配置缓存、路由缓存都各自独立,cache:clear 对它们完全无效。很多人清了 storage/framework/cache/data/,却发现 APP_NAME 还是旧值、新路由 404、Blade 修改不生效——其实问题压根不在 file 缓存。
真正要一起清的,是这四个目录/文件:
-
bootstrap/cache/config.php→ 用php artisan config:clear -
bootstrap/cache/routes-v*.php→ 用php artisan route:clear -
storage/framework/views/→ 用php artisan view:clear -
storage/framework/cache/data/→ 用php artisan cache:clear --driver=file
file 缓存的“静默性”最强:它不报错、不警告、不阻塞请求,只悄悄拖慢 I/O 并占用磁盘。上线前扫一遍 du -sh storage/framework/cache/*,比等报警更管用。


















