ThinkPHP 8.1 缓存路径由配置项动态决定，非法路径（如含../、中文、权限不足）会被静默忽略并回退默认路径；最可靠方式是代码中调用config()或RUNTIME_PATH确认实际路径，常见默认路径均位于runtime/下。
ThinkPHP 8.1 的缓存目录不是固定死的，而是由配置决定的，默认路径可能不生效，尤其在升级或部署后容易“找不到缓存文件”——这通常不是文件被删了，而是框架压根没写到你以为的位置。
缓存目录的真实路径怎么确认？
ThinkPHP 8.1 所有缓存路径（模板、配置、路由、数据库字段等）都受对应配置项控制，且会做合法性校验。非法路径（如含 ../、中文、空值、权限不足）会被静默忽略，自动回退到默认路径。
最可靠的方法是直接在代码里查：
// 在任意控制器或命令行中执行
var_dump(config('template.template_cache_path')); // 模板缓存路径
var_dump(config('cache.default.path')); // 默认缓存驱动路径（如 File 驱动）
var_dump(RUNTIME_PATH); // runtime 根目录（多数缓存放这里）常见默认路径如下（仅当配置未生效时 fallback）：
立即学习“PHP免费学习笔记（深入）”；
- 模板缓存：
runtime/template/ - 路由缓存：
runtime/route.php - 配置缓存：
runtime/config.php - 数据库字段缓存：
runtime/schema/或runtime/temp/ - 普通缓存（File 驱动）：
runtime/cache/
⚠️ 注意：RUNTIME_PATH 本身也可能是配置项 'runtime_path' 控制的，不是绝对固定。
找不到缓存文件的常见原因和应对
路径配置含非法字符
template_cache_path中出现中文、空格、../、~等，会被框架跳过，不报错也不提示。改用英文路径，例如：'template_cache_path' => __DIR__ . '/runtime/template/'-
目录不可写
Web 进程用户（如www-data、nginx或 Docker 中的非 root UID）对runtime/及其子目录无写权限，会导致缓存文件创建失败或为空。检查并修复：chmod -R 755 runtime/ chown -R www-data:www-data runtime/
-
APP_DEBUG = true
开发模式下，框架默认跳过所有磁盘缓存（模板、路由、配置都不生成）。运行以下代码确认：var_dump(config('app.app_debug')); // 必须为 false 才会生成缓存文件 OPCache 或 CLI PHP 版本不一致
比如你用 PHP 8.2 运行php think config:cache，但 Web 服务器跑的是 PHP 8.1，可能导致runtime/config.php生成后因语法兼容问题被框架静默忽略。确保 CLI 和 FPM 使用同一版本 PHP。-
缓存命令未真正执行成功
php think config:cache或php think route:cache命令失败时常常不报错，只因runtime/不可写或配置解析出错。执行后务必验证文件是否存在且非空：ls -lh runtime/config.php head -n 5 runtime/config.php
快速定位与清理建议
-
清理全部缓存（推荐用于排查）：
php think clear:all
它会清空
runtime/下所有缓存子目录，比手动删更彻底。 -
若只想清模板缓存，又不确定路径，可先强制刷新：
\think\Cache::clear('template'); // 清除模板缓存驱动内容再配合
rm -rf runtime/template/*彻底重来。 -
生产环境上线前，建议在部署脚本中加入路径校验：
[ -w "runtime/" ] || { echo "ERROR: runtime/ not writable"; exit 1; } php think config:cache && php think route:cache --annotation
不复杂但容易忽略
