ThinkPHP 8 路由匹配基于 REQUEST_URI 字符串顺序比对，静态路径须置顶、变量规则按优先级排列，约束需显式声明，分组为独立作用域，缓存仅保存映射关系。
ThinkPHP 8 路由分类默认处理机制决定请求是否能命中控制器、变量能否正确提取、404 是否该出现——它不靠服务器 rewrite，而是 PHP 层逐条比对 REQUEST_URI 字符串，顺序错一位、约束漏一个、分组嵌套深一层，就足以让 /user/123/edit 返回 404 或把 edit 当作 id 值传进去。
路由匹配本质是字符串顺序匹配
框架启动后，Route::dispatch() 从 $_SERVER['REQUEST_URI'] 中截取路径部分（如 /api/v1/users/123），去掉域名、查询参数和入口文件前缀，再按注册顺序逐条比对规则。
每条 Route::get('user/:id', 'User/read') 内部会转成类似 ~^user/([^/]+?)/?$~ 的正则，用 preg_match 提取捕获组；【:id 默认等价于 ([^/]+?)，不支持中文或斜杠】，所以 /user/张三 会匹配失败，/user/123/edit 会被截成 :id = "123/edit"。
静态路径必须排最前，否则会被带变量的规则吞掉。
立即学习“PHP免费学习笔记（深入）”；
路由规则注册顺序决定命中的优先级
第一步：打开 route/app.php，把所有不含变量的完整路径移到最前面。
Route::get('admin/login', 'Admin/Login/index');
Route::get('api/status', 'Api/Status/check');
Route::get('user/profile', 'User/profile');
第二步：含单一变量的规则紧接其后，但要确保不会覆盖子路径。比如 user/:id 必须写在 user/:id/edit 之前，否则后者永远无法命中。
第三步：多级变量或通配符规则放最后。Route::get('user/*', 'User/other') 这类规则一旦提前，就会吃掉所有以 user/ 开头的请求。
【Route::miss() 必须放在所有 Route::get/Route::post 之后】，它只在全部已注册规则遍历完仍未匹配时才触发。
变量约束必须显式声明才能突破默认限制
方法一：内联正则，直接改写路由表达式。
Route::get('user/:id([0-9]+)', 'User/read');
Route::get('post/:year([0-9]{4})/:month([01][0-9])', 'Post/archive');
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
方法二：用 ->pattern() 显式声明局部约束，比全局 __pattern__ 更安全。
Route::get('detail/:token', 'Index/detail')->pattern(['token' => '\S+']);
这一步很关键：默认 :token 遇到 URL 中的 / 就停，而 \S+ 能吞掉 Base64 编码里的斜杠；但别用 .*,它会一路吃到 URL 末尾，导致后续路由段丢失。
方法三：全局变量规则，在 route/app.php 顶部统一设置。
Route::pattern(['id' => '[0-9]+', 'slug' => '[a-z0-9\-]+']);
路由分组不是语法糖，而是独立作用域
Route::group('api/v1', function () { Route::get('users', 'api/User@index'); }); 这个闭包创建了一个新作用域，所有子路由自动拼上前缀 api/v1，且可单独绑定中间件、变量规则、跨域配置。
【Route::group('api')→get() 是无效语法，会直接报错】，必须用闭包包裹子路由。
嵌套分组不会自动继承外层中间件——Route::group('admin')->group('user') 里的 user 分组，不写 middleware 就不会执行鉴权。
跨域配置必须协同分组：})->allowCrossDomain(['https://admin.example.com'], true); 若传 true 却用 * 通配域名，浏览器将拒绝请求。
路由缓存只保存映射关系，不缓存逻辑
开启路由缓存后，框架把解析后的规则数组序列化写入 runtime/route.php，仅保存「路径 → 控制器/方法/参数」的映射关系。
缓存文件不包含任何逻辑判断或闭包回调，所以中间件、条件路由、动态生成的规则不会被缓存。
修改路由定义后必须手动清除缓存：php think optimize:route。
