Laravel路由统一前缀用Route::group(['prefix' => 'xxx'])实现，前缀开头带/不自动补、不带/则自动补，多斜杠会合并，动态段须放内部；多层group可模拟嵌套，前缀与中间件叠加，namespace需显式声明且不继承，as设置命名前缀与name()拼接，冲突时后注册覆盖前注册。
怎么用 prefix 给 Laravel 路由加统一前缀
直接在 Route::group() 里传 prefix 数组键就行，不需要额外注册或中间件配合。注意前缀末尾不自动补 /，手抖多写或少写斜杠都会导致 404。
- 前缀开头带
/（如'prefix' => '/api/v1'）：生成的 URL 是/api/v1/users - 前缀不带开头
/（如'prefix' => 'admin'）：Laravel 会自动补，效果一样 - 多个连续斜杠（
'prefix' => '/api//v1'）会被合并，但可读性差，别这么写 - 前缀里不要用动态段（如
'prefix' => '{tenant}'），Laravel 不支持 —— 动态段得放在 group 内部的 route 定义里
Route::group(['prefix' => 'api/v1'], function () {
Route::get('users', [UserController::class, 'index']); // 对应 /api/v1/users
Route::post('posts', [PostController::class, 'store']); // 对应 /api/v1/posts
});
Laravel 多级路由嵌套是否可行？实际怎么组织
Laravel 路由本身不支持语法上的“嵌套”（比如 Route::group->group->get 这种链式嵌套），但可以用多层 Route::group() 模拟层级结构。关键是每层都独立作用于其内部路由，且前缀和中间件会叠加。
- 外层 prefix 是
admin，内层是users→ 最终路径是/admin/users/list - 外层用
auth:sanctum，内层加can:manage-users→ 中间件按定义顺序执行 - 命名空间不会自动继承，每层 group 都要显式声明
namespace，否则控制器解析失败 - 避免过深嵌套（超过 3 层），调试路由列表（
php artisan route:list）时容易看花眼
Route::group(['prefix' => 'admin', 'middleware' => ['auth:sanctum']], function () {
Route::group(['prefix' => 'users', 'namespace' => 'Admin'], function () {
Route::get('list', [UserController::class, 'index']);
Route::get('{id}', [UserController::class, 'show']);
});
Route::group(['prefix' => 'settings', 'namespace' => 'Admin'], function () {
Route::get('general', [SettingController::class, 'general']);
});
});
命名空间怎么隔离？为什么加了 namespace 还报 Class not found
namespace 只影响当前 group 内控制器字符串的自动补全，它不是 PHP 的命名空间导入机制。常见错误是拼错路径、漏掉 App\Http\Controllers 前缀，或没运行 composer dump-autoload。
- 默认控制器路径是
App\Http\Controllers，所以'namespace' => 'Admin'实际找的是App\Http\Controllers\Admin\... - 如果控制器在
app/Http/Controllers/Admin/UserController.php，类声明必须是namespace App\Http\Controllers\Admin; - 用了
as命名路由时，别在 group 外重复定义同名路由，否则后注册的会覆盖前一个 - 想彻底隔离不同模块（比如后台 vs API），建议用不同的 service provider 分开加载路由文件，而不是全堆在
routes/web.php
Route::group([
'prefix' => 'api',
'namespace' => 'Api\V1',
'middleware' => 'api',
'as' => 'api.v1.',
], function () {
Route::get('posts', [PostController::class, 'index'])->name('posts.index');
// 最终路由名为 api.v1.posts.index，控制器类路径为 App\Http\Controllers\Api\V1\PostController
});
路由命名冲突和 as 前缀叠加的坑
as 在 group 上设置的是「命名前缀」，不是完整名称；它和内部 route 的 name() 会用 . 拼接。最容易出错的是拼接后重名，或者漏掉 name() 导致整个路由无名。
-
'as' => 'admin.'+->name('users.index')→ 全名是admin.users.index -
'as' => 'admin.'+->name('index')→ 全名是admin.index（可能和别的 admin.index 冲突） - 两个 group 都设
'as' => 'api.'，又都定义->name('users')，第二个会覆盖第一个 - 生成 URL 时用
route('admin.users.index')，如果名字拼错或没生效，抛出Route [xxx] not defined
php artisan route:list --name=xxx 精准验证最终生成的 name 和 URI，而不是凭感觉猜。 
