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