Route::group()是唯一合法路由分组入口，其第一个参数必须为含middleware、prefix、as等键的关联数组，否则中间件不执行、prefix不拼接、命名路由无法解析；prefix不加开头斜杠，as须以字母开头并结尾加点号，修改后需手动清缓存。
Route::group() 是唯一合法的路由分组入口，其他写法全无效——不报错，但中间件不执行、prefix 不拼接、route() 找不到命名路由。
为什么 Route::group() 第一个参数必须是数组
路由解析器只扫描 Route::group() 的第一个参数（必须是关联数组），其余参数（比如第二个数组、闭包外的 middleware 调用）会被直接忽略。常见错误包括：
-
Route::get(['middleware' => 'auth'], '/dashboard')→ Laravel 把数组当控制器名，报Target class [Array] does not exist -
Route::group(['prefix' => 'admin'], ['middleware' => ['auth']], function () { ... })→ 第二个数组被丢弃，中间件失效 - 把
middleware('auth')写在闭包里 → 闭包内无此函数，PHP 报Call to undefined function middleware()
prefix 和 as 的格式陷阱
看似小细节，实际决定 URL 是否可访问、route() 是否能解析成功：
-
'prefix' => '/admin'→ 实际匹配//admin/dashboard（双斜杠），Nginx 或 CDN 可能 404；正确写法：'prefix' => 'admin' -
'as' => 'admin'（结尾没点）→route('admin.dashboard')报Route [admin.dashboard] not defined；必须写成'as' => 'admin.' - 嵌套分组时：
prefix会自动拼接（'api'+'v1'→/api/v1），但as不连点，'as' => 'api.'内再写'as' => 'v1.'才能得到api.v1.users
中间件必须显式声明在配置数组里
中间件不会“继承”，也不会“扩散”，漏写或位置错，等于没加：
- ✅ 正确：
Route::group(['middleware' => ['auth', 'throttle:60,1']], function () { ... }) - ✅ 兼容写法（Laravel 5.5+）：
Route::middleware(['auth'])->group(function () { ... }) - ❌ 错误：
Route::group(function () { middleware(['auth']); ... })（闭包内无该函数） - ❌ 错误：
'middleware' => auth（PHP 报Use of undefined constant auth）；必须带引号且为数组：['auth'] - ⚠️ 性能隐患：外层
auth+ 内层又写auth→ 同一请求执行两次登录校验，throttle 计数翻倍
修改后必须手动清缓存
哪怕只是改了一个 prefix 或加了个中间件，只要运行过 php artisan route:cache，就必须执行：
php artisan route:clear
否则修改完全不生效——Laravel 会直接加载缓存文件，跳过 routes/web.php 的任何变更。线上环境尤其容易踩这个坑，route:list 显示的还是旧路由。
最易被忽略的是：控制器方法名拼错（如 'UserController@indxe'）时，中间件仍会完整执行一遍，最后才抛出方法不存在异常。上线前务必用 php artisan route:list --name=xxx 核对真实绑定目标。
