ThinkPHP5路由分组必须用闭包定义，否则前缀、中间件、pattern等失效；正确写法为Route::group('api', function(){ Route::get('user','api/User/index'); })。
ThinkPHP5 的路由分组必须用闭包定义，否则前缀、中间件、pattern 等配置全部失效——这不是可选项，是硬性限制。
Route::group() 必须配闭包，不能直接链式调用 get/post
常见错误是写成 Route::group('api')->get('user', 'api/User/index')，看着顺手，但实际什么都没注册成功。因为 Route::group() 返回的是 RuleGroup 实例，它不提供 get() 方法；所有子路由必须在闭包里用 Route::get()、Route::post() 等静态方法注册。
- ✅ 正确：
Route::group('api', function () { Route::get('user', 'api/User/index'); }); - ❌ 错误：
Route::group('api')->get('user', 'api/User/index');（get()无处可调） - ❌ 错误：
Route::group('api', Route::get('user', '...'));（第二个参数必须是闭包，不是路由对象） - ⚠️ 注意：闭包必须在路由加载阶段执行，比如写在
app/route/app.php里；若在控制器或中间件中调用，此时路由已固化，完全无效
分组前缀拼接时斜杠处理不当会导致 404
ThinkPHP 不会自动修复双斜杠，//api/v1//user 这种路径直接匹配失败。手动加斜杠是最容易翻车的地方。
- ✅ 推荐写法：
Route::group('api/v1', function () { Route::get('user', '...'); });→ 匹配/api/v1/user - ❌ 危险写法：
Route::group('/api/v1/', function () { Route::get('/user', '...'); });→ 实际注册为//api/v1//user - ? 验证方式：开启调试模式后访问
http://yourdomain.com/route:list，看真实注册的完整路径 - ?
->prefix('api/v1/')链式调用更安全，它会自动去重补斜杠，但只作用于闭包内注册的路由
分组内资源路由必须显式指定命名空间
用 Route::resource() 时，URL 前缀会继承，但控制器类不会自动加上分组名作为命名空间前缀。漏掉这步，Class not found 几乎必现。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- ❌ 默认行为：
Route::group('admin', function () { Route::resource('user', 'User'); });→ 控制器解析为app\controller\User，不是app\controller\admin\User - ✅ 修复方式一：
Route::resource('user', 'admin.User')->namespace('admin'); - ✅ 修复方式二（推荐）：
Route::group('admin', function () { Route::resource('user', 'User')->namespace('admin'); }); - ⚠️ 中间件也得挂到分组对象上：
->middleware(['Auth'])，不能塞进闭包里，否则只对最后一条路由生效，或报Call to a member function middleware() on null
变量规则和后缀要统一设在分组对象上，别每条重复写
分组支持批量约束参数格式和 URL 后缀，这是为了减少冗余、避免漏配。但 pattern 和 ext 是“继承式”生效，不是“覆盖式”。
-
->pattern(['id' => '\d+', 'name' => '\w+'])：所有含:id或:name的路由都受限制，不匹配直接 404 -
->ext('json')：该分组下所有路由自动识别.json后缀（如/api/user/1.json），无需手动解析 -
->prefix('api/v1/')比把前缀写在分组名里更可控，避免分组名被误当路径使用 - ⚠️ 延迟解析（
'url_lazy_route' => true）开启后，若分组里用了动态生成路由（比如循环读配置），反而每次请求都重新加载整个分组——比预加载还慢
真正容易被忽略的是：分组不是语法糖，它是路由匹配性能的关键环节。一旦闭包没写对、斜杠多加一个、命名空间漏指定，问题往往表现为 404 或 Class not found，而不是明确报错，排查起来特别绕。
