ThinkPHP 6.0 路由延迟解析仅在 APP_DEBUG=false 且 runtime/route.php 存在时生效，需显式开启 route_check_cache、正确生成缓存文件并配置自定义缓存键，否则退化为全量实时扫描。
ThinkPHP 6.0 路由延迟解析提升性能的真相，是框架在请求生命周期中将路由匹配从“每次必做”改为“按需触发”，但该机制仅在关闭调试模式、启用缓存且缓存文件真实加载的前提下才生效；若 runtime/route.php 不存在或 APP_DEBUG=true，延迟解析自动退化为全量实时扫描。
确认是否真正进入延迟解析路径
执行 php -r "var_dump(\think\App::debug(), is_file(RUNTIME_PATH . 'route.php'));"，输出必须为 bool(false) bool(true)。前者为 false 表示 APP_DEBUG 已关闭，后者为 true 表示缓存文件存在且可读——【二者缺一不可，任一为 false 都意味着仍在走全量路由解析】。
不要依赖 php think route:list 的输出判断，它始终解析源码，与运行时行为无关。
开启路由缓存的三步强制链
第一步：在 config/app.php 中显式设置 'route_check_cache' => true。TP6.0 默认不开启此开关，仅生成 route.php 文件而未打开该配置，缓存完全不会被读取。
立即学习“PHP免费学习笔记（深入）”；
第二步：确保 APP_DEBUG = false 且 runtime 目录对 Web 进程可写。若权限不足，php think route:cache 命令会静默失败，不报错也不生成文件。
第三步：执行 php think route:cache。成功后 runtime/route/route.php 文件应包含类似 return ['GET|/index/hello'=>['index/hello',[]]]; 的数组结构，而非空文件或 parse error 报错内容。
注解路由的延迟解析陷阱
方法一：禁用注解扫描，改用静态路由定义。注解路由（@Route）在 TP6.0 中无法被真正“延迟”，因为 think\Route::importAnnotations() 在首次请求时仍会强制反射全部控制器类，耗时随控制器数量线性增长。
方法二：若必须保留注解，需限定扫描路径。在 config/route.php 中添加 'annotation_paths' => [app_path('controller/User.php')]，避免自动扫描整个 app/controller/ 目录。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
方法三：升级至 TP8.0 并使用 php think optimize:annotate 提前生成注解映射，再配合 route:cache 使用——但该命令在 TP6.0 中不存在，强行调用会报错。
注意：TP6.0 不支持 PHP 8 Attributes（#[Route]），只识别 PHPDoc 注解；写在 trait 或父类中的 @Route 不会被采集，缓存生成阶段直接跳过。
自定义缓存键绕过无效击穿
默认缓存键含完整 URL（含 query 参数），导致 /api/user 和 /api/user?_t=123 被视为两个 key。在 config/route.php 中加入：
'route_check_cache_key' => function($request) { return $request->pathinfo() . ':' . $request->method(); }
这一步必须做，否则 AJAX、Pjax、带时间戳参数的前端请求会持续击穿缓存，使延迟解析形同虚设。
清理旧缓存的硬性操作
① 修改 route/app.php 或任意控制器注解后，必须立即执行 php think clear --route；
② 然后重新运行 php think route:cache；
③ 最后验证 is_file(RUNTIME_PATH . 'route.php') 返回 true 且内容非空。
缓存不会自动更新，旧文件残留会导致新路由规则永不生效，且无任何错误提示——这是最常被忽略的线上故障根源。
