ThinkPHP 8.0需确保路由缓存生效：设config/app.php中'app_debug'=>false，route.php启用'route_cache'=>true，runtime/可写，执行php think route:cache（注解路由加--annotation），删runtime/route.php并验证无残留，最后通过日志“Route cache loaded”及curl耗时对比确认生效。
ThinkPHP 8.0项目上线后路由匹配变慢，页面加载延迟明显，需立即生成并验证路由缓存是否真正生效，避免因缓存未启用或文件损坏导致每次请求都全量解析路由规则。
确认路由缓存启用前提
打开 config/app.php 文件，找到 'app_debug' 配置项，将其值设为 【false】。仅修改 .env 中的 APP_DEBUG=false 不保险，框架最终以该 PHP 配置为准。
检查 config/route.php 是否存在且返回数组中包含 'route_cache' => true。若不存在此配置项，手动添加进去；多应用模式下，每个应用子目录下的 config/route.php 都要单独设置。
确保 runtime/ 目录及其子目录对 Web 进程用户（如 www-data、nginx）具有可写权限。Docker 环境中常见 UID 不一致导致 runtime/route.php 静默生成失败，此时命令不报错但文件为空或根本没创建。
立即学习“PHP免费学习笔记（深入）”；
生成路由缓存文件
在项目根目录终端执行：php think route:cache。
命令执行成功后，检查 runtime/route.php 是否真实存在且内容非空数组——打开该文件，应看到类似 return ['index/index' => ['index/index', 'GET', [], []]]; 的结构化 PHP 数组。若内容是 return []; 或语法错误（如含 PHP 8.1 特性但 CLI 使用 PHP 8.0），则缓存逻辑会在运行时自动 fallback 到源码解析，等于没开。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
注解路由需额外加参数扫描：若控制器中使用 @Route 注解，必须执行 php think route:cache --annotation，否则 app/controller/ 下的注解不会被采集。
清除旧路由缓存
方法一：使用内置命令清理
在项目根目录终端执行：php think clear:route。这是最稳妥的方式，会精准删除 runtime/route.php 及相关临时索引文件。
方法二：手动删除 + 验证
先删除 runtime/route.php 文件；再检查 runtime/ 下是否存在隐藏文件（如 .route.php.swp），IDE 编辑器可能残留同名临时文件导致“看似删了实则还在”；最后用 ls -la runtime/ | grep route 确认无任何 route 相关文件残留。
方法三：Swoole/Hyperf 常驻进程场景
仅删文件不够，必须 reload 所有工作进程，否则旧缓存仍驻留在内存中。执行 php think swoole restart 或向主进程发送 SIGUSR2 信号。
验证缓存是否真实生效
第一步：检查 APP_DEBUG 最终值
在任意控制器中插入 var_dump(config('app.app_debug'));，访问对应接口，确认输出为 bool(false)。
第二步：触发一次路由匹配并观察日志
在浏览器中访问一个已定义的路由（如 /index），同时打开 runtime/log/ 目录下最新日期的日志文件，搜索关键词 “Route cache loaded”，出现即表示磁盘缓存已被加载。
第三步：对比耗时差异
用 curl -w “\n%{time_total}\n” -o /dev/null -s http://your-domain.com/index，分别在开启和关闭 route_cache 时各测 3 次，取平均值。开启后应稳定低于 5ms，关闭状态常达 15ms 以上——差距明显说明缓存已起效。
