应按业务域拆分路由文件并动态导入，正确设置Route::group的prefix和namespace，统一命名规范，手动实现嵌套路由并约束参数格式。
路由文件太大导致加载慢、热更新失效
ThinkPHP 6 默认把所有路由写在 app/route/app.php，项目一上规模，这个文件动辄上千行，每次请求都要完整解析——哪怕只访问一个接口，也要加载全部路由规则。更麻烦的是，Swoole 或 RoadRunner 环境下，路由一旦加载进内存，改了文件也不会自动重载，调试时得手动 reload 进程。
实操建议：
- 把路由按模块拆到独立文件，用 Route::import() 动态引入
- 拆分原则不是“按控制器”，而是“按业务域”（比如 route/api/v1/order.php、route/admin/auth.php）
- 在 app/route/app.php 里只留一句 Route::import('route/api.php');，再由 route/api.php 去 import 更细的子文件
- 避免在 import 的子文件里调用 Route::middleware() 全局设中间件，它会覆盖外层配置；应该在 import 前就用 Route::group() 包一层并指定中间件
使用 Route::group() 时 prefix 写错导致 404
常见错误是把 prefix 当成 URL 路径前缀硬塞，比如写成 Route::group(['prefix' => '/api/v1'], function () { ... });，结果所有路由都变成 /api/v1//user（多了一个斜杠），或者和 Nginx 的 location 配置冲突，实际访问 /api/v1/user 却 404。
实操建议：
- prefix 值不要以 / 开头，也不要以 / 结尾，正确写法是 ['prefix' => 'api/v1']
- 如果 Nginx 已配置 location /api/ { ... }，那么 ThinkPHP 路由应去掉 api，只保留 v1 作为 prefix，否则路径被重复匹配
- Route::group() 的 namespace 参数别漏写，否则闭包里用 controller 方法会找不到类，报 Class not found
闭包路由和控制器路由混用引发命名冲突
项目初期用闭包写几个快速接口，后期补控制器，但没注意命名空间和路由名（as）重复。比如闭包定义了 Route::get('user', ...)->name('user.index')，后面又加了 Route::get('user', 'UserController@index')->name('user.index')，运行时后者会覆盖前者，但调试时可能只测了新接口，老逻辑就静默失效了。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
实操建议：
- 所有路由必须显式声明 ->name()，且保证全局唯一；建议格式为 模块.动作，如 admin.user.list、api.v1.order.create
- 避免在同一个 group 里混用闭包和控制器路由；如果必须共存，闭包路由加个临时前缀，比如 ->name('dev.test.ping')
- 利用 php think route:list 定期检查重复 name 和未命名路由，该命令输出里 Name 列为空的，就是隐患点
RESTful 路由 + 资源路由嵌套导致参数解析失败
用 Route::resource('order', 'OrderController') 加上嵌套路由（比如 Route::resource('user.order', 'UserOrderController')），结果 /user/123/order 里的 123 总是拿不到，$this->request->param('id') 是空，或者被当成 order 的 id 而非 user 的 id。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- ThinkPHP 的 resource 不支持原生嵌套，user.order 生成的其实是 /user.order 这种扁平路径，不是树状结构
- 真正要嵌套，得手动写： Route::group('user/:id', function () { Route::get('order', 'UserOrderController@list'); })->pattern(['id' => '\d+']);
- 手动路由里必须加 ->pattern() 显式约束参数格式，否则 :id 会匹配任意字符串，干扰后续路由匹配顺序
- 如果用了 Route::miss() 兜底，它会吃掉所有未匹配路由，导致嵌套参数根本没机会解析，慎用
路由拆分本身不难，难的是拆完之后的命名一致性、参数传递链路、以及 Swoole 下的缓存刷新节奏。很多人卡在「拆完了，但某个接口突然 404」，大概率是 prefix 多了个斜杠，或者 php think route:clear 没跑全。
