ThinkPHP清理缓存需精准操作：严禁rm -rf runtime/，应只清子目录文件并保留目录结构；模板不更新因未清runtime/view/或temp/；404因未清route.php和config.php；Cache::clear()无效可能因路径错配或多Redis实例未显式指定store。
ThinkPHP新手第一次清理缓存时，常因不了解Runtime目录的分层结构和缓存驱动差异，删错目录、漏清关键文件，导致模板不更新、路由404、配置失效甚至服务启动失败。
误删整个runtime/目录引发服务瘫痪
直接执行 rm -rf runtime/ 或在资源管理器里全选删除 runtime 文件夹——这是最危险的操作。Runtime 下除 cache/ 外，log/ 存日志写入句柄，temp/ 存模板编译后的 .php 文件，data/ 存 route.php 和 config.php，session/ 可能正被用户会话占用。暴力清空会中断正在写的日志、让下次请求卡在 fopen()、触发 Class not found 错误。
正确做法是只清子目录内容，保留目录结构本身：rm -f runtime/cache/* runtime/log/* runtime/temp/*.php runtime/data/*.php。
【必须保留 runtime/log/ 目录本身】——删掉目录会导致后续日志写入报 failed to open stream 错误，且框架可能拒绝启动。
立即学习“PHP免费学习笔记（深入）”；
只清 cache/ 却发现模板还是旧的
ThinkPHP 的模板缓存（编译后 PHP 文件）默认存在 runtime/view/（TP6）或 runtime/temp/（TP5），和 runtime/cache/ 完全无关。你清了 cache/，但 runtime/view/index.html.php 还在，修改的 HTML 模板永远不生效。
方法一：命令行强制清模板缓存
TP6.1+ 执行 php think clear:template；TP5 则需手动 rm -f runtime/view/*。
方法二：代码中清除
调用 \think\facade\Cache::clear('view')（TP6）或 \think\facade\Cache::clear('temp')（TP5），注意参数名不是 'template' 也不是 'view' 在 TP5 中实际对应 temp 驱动。
执行 php think clear 后页面 404 或白屏
这是因为 php think clear 默认不清理 runtime/route.php（路由缓存）和 runtime/data/config.php（配置缓存）。删了 cache/ 和 log/，但 route.php 还在，新添加的 Route::get('/api/test') 根本不注册；config.php 没刷新，数据库 host 变成 null。
第一步：确认是否真需要清路由缓存
运行 php think route:list，如果输出正常但访问报 404，说明 route.php 没被清。
第二步：针对性清理
TP6 执行 php think route:clear；TP5 直接删 runtime/route.php。
第三步：检查配置缓存
TP6 中配置缓存默认写入 runtime/data/config.php，删它即可；TP5 若启用了 config_cache，同样删 runtime/data/config.php。
Cache::clear() 在控制器里调了却没反应
常见原因是缓存驱动配置未生效或路径错配。比如 config/cache.php 里 stores['file']['path'] 设为 '/tmp/my_cache'，但 .env 里 CACHE_PATH=/var/www/runtime/cache，代码里 Cache::clear() 默认去清 /tmp/my_cache，而你实际缓存文件在 /var/www/runtime/cache 下。
方法一：显式指定 store 名称
Cache::store('file')->clear()，避免依赖容器自动解析 default 配置。
方法二：验证真实路径
执行 var_dump(config('cache.stores.file.path'))，再用 file_exists() 检查该路径下是否有缓存文件，别只信 Cache::clear() 返回 true。
【不要在控制器里调用 Dir::delete(runtime_path())】——并发请求下可能删到其他进程正写入的临时文件，引发不可预知错误。
以为清了 Redis 缓存，其实 key 还在
php think clear --all 只清文件缓存，对 Redis 无影响；Cache::clear() 默认只清当前 store，若你配置了多个 Redis 实例（如 'redis_user' 和 'redis_order'），调用 Cache::clear() 不会清 'redis_order' 里的数据。
第一步：确认当前默认 store 是否为 redis
dump(config('cache.default'))，确保是 'redis' 而非 'file'。
第二步：显式切换并清理
Cache::store('redis_user')->clear()；Cache::store('redis_order')->clear()。
第三步：验证 Redis 状态
用 redis-cli 连上后执行 keys "think_*"，看是否还有残留 key；若用了 tag 缓存，必须用 Cache::tag('user')->clear()，普通 clear 无效。
