laravel 9 和 11 路由分组机制核心一致：必须用 route::group()，配置统一写于首参数数组，嵌套会叠加 prefix 并合并 middleware；差异仅在语法推荐（如箭头函数）和错误提示优化，底层完全兼容。
Laravel 9 和 11 在路由分组机制上保持高度一致，核心逻辑未变：必须用 Route::group()，不能链式调用或数组直传；前缀、中间件、命名空间等配置需统一写在第一个参数数组中；嵌套分组会叠加 prefix 和合并 middleware。差异主要体现在语法支持（如 Laravel 11 更推荐箭头函数写法）和开发者体验优化（如更明确的错误提示），但底层行为完全兼容。
中间件组必须先注册再使用
中间件组（如 'admin'）不是写在路由里就自动生效的。必须先在 app/Http/Kernel.php 的 $middlewareGroups 中明确定义，包含完整执行链（含 Session、Cookie 等基础中间件），否则调用 ->middleware('admin') 会静默失败或报错“Undefined middleware group”。
- 注册时注意顺序：身份验证类（如
AdminAuthMiddleware）应放在SubstituteBindings::class之后，确保路由参数已解析 - 带参数的中间件（如
throttle:60,1）不能放进$middlewareGroups，只能在Route::group()中单独声明 - 验证是否生效：运行
php artisan route:list，检查对应路由的 Middlewares 列是否显示你定义的组名
前缀配置要扁平，避免斜杠陷阱
prefix 值不自动补斜杠，也不自动去重，多写或少写都会影响匹配结果。正确写法是统一不加开头和结尾斜杠，让 Laravel 自动拼接。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- ✅ 推荐：
'prefix' => 'api/v1'+get('users')→ 实际路径为/api/v1/users - ❌ 错误：
'prefix' => '/api/v1/'+get('/users')→ 可能生成//api/v1//users，虽多数情况仍可访问，但不符合规范且易引发重定向异常 - 动态段（如
{locale}）必须放在 group 内部的路由定义中，不能写在 prefix 值里
嵌套分组要控制层级，优先用单层组合
虽然 Laravel 支持多层 Route::group() 嵌套，但每层都会叠加 prefix 并合并 middleware，超过两层后调试困难、可读性下降。
- 推荐写法：把权限、版本、模块拆成单层组合，例如
['prefix' => 'api/v1', 'middleware' => ['auth:sanctum', 'role:admin']] - 嵌套仅用于必要场景，比如子域名 + 版本 + 模块三者分离：外层按
domain('{tenant}.app.com')，内层再分prefix('v2')和prefix('billing') - 命名空间（
namespace）不继承，每层 group 都要显式声明，Laravel 8+ 已弃用隐式命名空间，建议直接写完整控制器类名
名称前缀与路由生成要同步设计
用 as 键设置名称前缀，配合每个子路由的 ->name()，才能让 route('staff.profile') 这类调用清晰可靠。
-
Route::group(['as' => 'staff.', 'prefix' => 'staff'], function () { Route::get('profile', ...)->name('profile'); })生成的路由名为staff.profile - 资源路由可用
->names('orders')统一设置子动作名称，避免逐个写->name('staff.orders.index') - 路由缓存后修改分组配置，必须手动执行
php artisan route:clear，否则新 prefix 或 middleware 不生效
