路由分组是Laravel中组织中大型项目路由的必需手段；必须在共享前缀、中间件、命名空间、域名或路由名前缀时使用Route::group()，并注意prefix不加斜杠、as末尾带点、namespace相对路径、中间件已注册等配置要点。
路由分组在 Laravel 中不是“可选技巧”，而是组织中大型项目路由的必需手段；不加合理分组，routes/web.php 很快会变成难以维护的面条代码。
什么时候必须用 Route::group()
当多个路由共享以下任一特征时，就应该抽成组：
- 相同前缀（如所有后台路由都以
/admin开头） - 相同中间件（如
auth、verified、自定义权限中间件） - 相同命名空间（如控制器都在
App\Http\Controllers\Admin下） - 相同域名或子域名（如
api.example.com） - 相同路由名称前缀（便于
route()动态生成，如admin.users.index）
Route::group() 的核心参数怎么配
它接收两个参数：第一个是配置数组，第二个是闭包路由定义。常见组合如下：
Route::group([
'prefix' => 'admin',
'middleware' => ['auth', 'can:manage-dashboard'],
'namespace' => 'Admin',
'as' => 'admin.',
], function () {
Route::get('/users', [UserController::class, 'index'])->name('users.index');
Route::get('/settings', [SettingController::class, 'edit'])->name('settings.edit');
});
注意几个易错点：
-
prefix值开头不加/（Laravel 会自动处理），但结尾也不加 —— 否则生成 URL 时多出双斜杠 -
as末尾必须带点（.），否则route('adminusers.index')会找不到 -
namespace是相对于App\Http\Controllers\的路径，不写完整命名空间 - 中间件名必须已注册，未定义的中间件会导致
Target class [xxx] does not exist
嵌套分组与冲突避坑
可以嵌套，但要警惕中间件叠加和前缀拼接异常：
Route::group(['prefix' => 'api', 'middleware' => 'api'], function () {
Route::group(['prefix' => 'v1', 'middleware' => 'throttle:60,1'], function () {
Route::get('/posts', [PostController::class, 'index']); // 实际匹配 /api/v1/posts
});
});
常见问题：
- 嵌套后
prefix自动拼接，但若内层也写/v1（带斜杠），结果变成/api//v1，导致 404 - 外层和内层都加了
auth中间件，用户会校验两次 —— 不报错但浪费性能 -
as嵌套时不会自动追加点号，需手动补全：'as' => 'api.v1.'
资源路由 + 分组的正确写法
资源路由（Route::resource()）放进分组里很常见，但别漏掉 ->names()：
Route::group(['prefix' => 'admin', 'as' => 'admin.'], function () {
Route::resource('products', ProductController::class)
->names([
'index' => 'products.index',
'create' => 'products.create',
'store' => 'products.store',
// 其他方法同理，或直接用 ->names('products') 简写
]);
});
否则默认生成的路由名仍是 products.index，而非 admin.products.index，route() 查不到。
另外，->middleware() 要挂在资源链最后，不能写在 ->names() 前面，否则中间件不生效。
