最简可用的分组路由需满足前缀字符串和闭包定义两要素：Route::group('api', function () { Route::get('user/:id', 'api/User/read'); });，缺闭包或控制器路径错误均导致失效。
ThinkPHP 路由分组直接用 Route::group() 就能设，但不加参数或写错闭包结构，路由根本不会生效。
怎么写最简可用的分组路由
核心是两要素：前缀字符串 + 闭包定义内部路由。别漏掉闭包，也别把控制器路径写成相对路径（比如漏掉 api/ 前缀）。
-
Route::group('api', function () { Route::get('user/:id', 'api/User/read'); });—— ✅ 正确，api是分组名，闭包里写具体规则 -
Route::group('api', ['user/:id' => 'api/User/read']);—— ❌ ThinkPHP 5.1+ 不支持数组式写法（那是旧版 TP3 的语法） -
Route::group('api', function () { Route::get('user/:id', 'User/read'); });—— ⚠️ 错在控制器类没带命名空间前缀，实际会报Class User does not exist
为什么加中间件要链式调用，不能塞进闭包里
中间件必须挂载到分组对象上，不是挂在闭包里的某条路由上——否则只对最后一条生效，或直接报 Call to a member function middleware() on null。
-
Route::group('api', function () { /* ... */ })->middleware(['Auth', 'Log']);—— ✅ 全组统一加中间件 -
Route::group('api', function () { Route::get('user', '...')->middleware('Auth'); });—— ⚠️ 只给这一条加，且容易误以为整个分组都受控 - 中间件类名必须可解析：若用
Auth::class，确保app\middleware\Auth类存在且 handle 方法签名正确
变量规则和后缀怎么批量设置
分组支持统一约束参数格式和 URL 后缀，避免每条路由重复写 ->pattern() 或 ->ext()。
立即学习“PHP免费学习笔记（深入）”；
-
->pattern(['id' => '\d+', 'name' => '\w+'])—— 限制所有含:id或:name的路由，匹配失败直接 404 -
->ext('json')—— 所有该分组下的 URL 自动识别.json后缀（如/api/user/1.json），无需手动解析 -
->prefix('api/v1/')—— 更安全的写法：把前缀从分组名移到 prefix，避免分组名被误当路径（Route::group('v1', ...)->prefix('api/v1/')）
延迟解析开启后，分组路由反而变慢？
开启 'url_lazy_route' => true 本意是提升性能，但若你在分组里用了动态生成的路由（比如循环注册、读配置文件），延迟解析会导致每次请求都重新加载并解析整个分组——反而比预加载还慢。
- 确认是否真需要延迟：90% 的中小型项目关掉更稳（
'url_lazy_route' => false） - 开启后务必清缓存：
php think route:clear，否则旧规则残留，新分组不生效 - 调试时用
think\facade\Route::ruleList()查看当前已注册的完整分组列表，比猜强
真正麻烦的从来不是怎么写分组，而是改完 route/app.php 忘了清缓存，或者把 api/User 写成 User 导致类找不到——这两处卡住的人，比语法错误多三倍。
