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，而不是凭感觉猜。