Route::group()是唯一合法路由分组入口，配置项必须置于其首参数数组中；prefix和as需严格遵循格式（如'admin.'），嵌套时prefix拼接而as不自动连点，修改后须重缓存。
Route::group() 是唯一合法入口，别往 Route::get() 里塞配置
路由分组不是语法糖，是 Laravel 路由解析器的硬性约定：只有 Route::group() 的第一个参数数组会被识别为分组配置。任何试图把 prefix、middleware 塞进 Route::get(['prefix' => 'api'], ...) 的写法，Laravel 直接忽略——不报错，也不生效。
- 常见错误现象：
Route::get(['middleware' => 'auth'], '/dashboard', ...)看起来像分组，实际只是把数组当成了控制器方法名，最终抛出Target class [Array] does not exist - 正确姿势：必须用闭包包裹子路由，且配置项只出现在
Route::group()的第一个参数里 - 参数差异：
prefix控制 URI 路径，as控制路由名前缀，二者互不影响；想让route('admin.users.index')生效，as => 'admin.'和子路由的->name('users.index')缺一不可
prefix 和 as 的写法细节决定 URL 和 route() 能不能用
prefix 开头不加 /，结尾也不加；as 必须以字母开头、结尾带点号（如 'admin.'）。这两个看似小习惯，直接导致生成 URL 双斜杠或 route() 找不到命名路由。
- 常见错误现象：写成
'prefix' => '/admin'→ 实际匹配//admin/dashboard，某些 CDN 或 Nginx 配置下 404；写成'as' => 'admin'（没点）→route('admin.dashboard')报错“Route [admin.dashboard] not defined” - 嵌套分组时，
prefix会拼接（'api'+'v1'→/api/v1），但as不会自动连点，必须手动写成'as' => 'api.v1.' - 使用场景：多语言路由
'prefix' => '{locale}'、API 版本隔离'prefix' => 'api/v2'、后台模块'prefix' => 'admin/users'
中间件必须显式声明在分组配置里，否则等于没加
中间件不会“继承”或“扩散”，它只认 Route::group() 配置数组里的 middleware 键。漏写、写错位置、或用错格式，都会导致部分甚至全部子路由绕过校验。
- 常见错误现象：把
auth写在闭包外（Route::middleware('auth')->group(...)是对的，但use middleware('auth'); Route::group(...)完全无效）；或写成middleware => auth（缺引号和数组）→ PHP 报Use of undefined constant auth - 正确写法必须是数组：
'middleware' => ['auth', 'verified']或带参形式'throttle:60,1'（字符串，不是数组） - 性能影响：嵌套分组若重复加同一中间件（如外层
auth，内层又加auth），用户会校验两次，不报错但浪费请求周期
改了路由分组后本地正常、线上 404？先清缓存
运行过 php artisan route:cache 后，所有路由定义被固化为 PHP 数组，routes/web.php 里的任何修改（包括 Route::group() 的 prefix 或 middleware）都不会实时生效。
- 常见错误现象：开发环境改完分组，
php artisan serve测试正常；上线部署后跑route:cache，结果新路由 404，旧路由还能访问 - 解决办法：每次修改分组配置后，必须重新执行
php artisan route:cache；调试阶段可临时禁用缓存，或加 CI 步骤自动刷新 - 兼容性注意：Laravel 9+ 默认启用路由缓存，但
route:clear不会自动触发重缓存，需手动补上
最常被忽略的其实是嵌套分组里 as 的点号缺失和缓存未刷新——这两处问题不报错，只默默让 route() 失效或 URL 拼错，查起来特别费时间。
