Route::group()必须用闭包包裹且前缀不能带斜杠，控制器需写完整命名空间，URL生成须显式命名路由；版本化API需用字符串字面量分组，命名空间与目录结构须严格大小写对齐。
必须用 Route::group() 静态包裹，其他方式全失效。中间件改 PATH_INFO、Nginx rewrite、Route::domain() 配合、甚至 url.pathinfo_depr 配置，都不能让前缀真正参与路由匹配和 URL 生成双向流程。
为什么 Route::group('api', [...]) 写了却没生效
常见错误集中在三处：
-
Route::group('api', function () { ... });漏掉闭包 —— 没闭包，内部路由根本不会注册 - 前缀或子路径写了开头斜杠，比如
Route::group('/api/', function () { Route::get('/user', ...); });→ 实际匹配//api//user，404 - 控制器类名没带完整命名空间，如写成
'User/read'而非'api/User/read'，框架找不到类
url() 生成链接不带前缀？检查这三点
前缀加了但 url('user/read') 还是输出 /user/1，不是 /api/user/1，问题不在分组本身，而在 URL 反解机制：
- 没给路由显式命名：
Route::get('user/:id', 'api/User/read')->name('api.user');，然后必须用url('api.user', ['id' => 1]) - 用了数组式写法（已废弃）：
Route::group('api', ['user' => 'User/index'])→ TP6+ 不识别，路由不注册 - 混用了
Route::domain()：一旦在 group 外套 domain，url()就丢前缀和域名，这是底层冲突，不能共存
版本化 API 怎么配才稳
别用变量路由（如 Route::rule(':version/user', ...)），线上缓存和大小写敏感会突然崩。正确姿势是每个版本独立 group：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
Route::group('v1', function () {
Route::get('user/:id', 'api/v1.User/read');
Route::post('user', 'api/v1.User/create');
})->middleware('throttle:60,1');
Route::group('v2', function () {
Route::get('user/:id', 'api/v2.User/read');
Route::post('user', 'api/v2.User/create');
})->middleware('throttle:100,1');
注意：v1 和 v2 必须是字符串字面量，不能写成 config('api.version') 或变量 —— 否则路由缓存编译失败，开发环境正常，上线直接全站 404。
最易被忽略的是命名空间与目录结构的严格对齐：api/v1.User 对应 app/controller/api/v1/User.php，且文件首行必须是 namespace app\controller\api\v1;。Linux 下大小写错一个字母，就是 500 或 404。
