嵌套路由必须用 Route::group() 实现共享前缀、中间件、命名空间和名称前缀；不可仅靠路径拼接，否则导致维护困难、绑定失效、缓存覆盖等问题。
嵌套路由必须用 Route::group()，不能靠路径拼接
很多人以为写 Route::get('admin/users') 就算“嵌套”，其实这只是普通路径，没有路由层级关系。真正嵌套的核心是共享前缀、中间件、命名空间和路由名称前缀，必须用 Route::group() 显式声明。
常见错误现象：Route::get('api/v1/posts') 和 Route::get('api/v1/users') 看似嵌套，但中间件要重复写、命名得自己拼接、升级 v2 时改起来一团乱。
- 正确做法：用
prefix+middleware+as统一管理 -
as参数会自动加冒号分隔，比如as => 'api.v1.'，后面Route::get('posts', ...)->name('posts')最终生成的完整名是api.v1.posts - 如果嵌套多层（如 v1 → admin → users），不要嵌套
Route::group()，而是在一层里写清prefix => 'api/v1/admin'—— Laravel 不支持 group 套 group 的链式嵌套
Route::resource() 在嵌套路由里要手动指定参数绑定
在 Route::group(['prefix' => 'admin']) 里直接写 Route::resource('users', ...)，生成的路由参数默认还是 {user}，但控制器方法签名如果写成 show(User $user)，Laravel 默认按模型名找 route key，而实际 URL 是 /admin/users/{user} —— 看似没问题，但一旦加了软删除或自定义路由键，就容易 404。
- 必须显式绑定参数名：在 resource 外加
->parameters(['users' => 'user_id'])，让 URL 变成/admin/users/{user_id} - 或者在
Route::model()中提前注册绑定规则，比如Route::model('user_id', App\Models\User::class) - 不推荐依赖隐式绑定做嵌套资源，因为
$user和$admin_user这类变量名不会自动区分上下文
中间件顺序错位会导致嵌套路由失效
嵌套路由常用来隔离权限，比如 ['middleware' => ['auth', 'can:manage-users']]。但如果你在全局中间件里用了 SubstituteBindings（Laravel 默认启用），而自定义中间件又提前返回了响应（如权限校验失败跳转），就会导致模型绑定没执行，$user 为 null，后续逻辑崩掉。
- 检查中间件注册顺序：在
app/Http/Kernel.php的$middlewareGroups里，SubstituteBindings必须在权限中间件之前 - 更稳妥的做法：把权限校验写在控制器里，或用策略类（Policy），避免中间件过早中断绑定流程
- 调试技巧：在中间件里加
dd(request()->route());，确认parameterNames()是否已解析出预期参数
命名冲突和缓存会让嵌套路由“消失”
运行 php artisan route:list 看不到某组嵌套路由？大概率是缓存没刷新，或者路由名重复被覆盖。Laravel 路由缓存会把所有路由扁平化处理，一旦两个 as 值相同（比如都写了 as => 'users.index'），后定义的会覆盖前一个。
- 每次修改
as或prefix后，务必运行php artisan route:clear（开发环境）或php artisan route:cache（生产环境） - 避免手写重复路由名，用
as => 'admin.users.'+name('index')这种组合，而不是全写死name('admin.users.index') - 如果用了多语言路由或包路由，注意它们是否在
routes/web.php之后加载，可能把你的嵌套组覆盖掉
嵌套路由本身不难，难的是它把多个配置维度（前缀、中间件、命名、绑定、缓存）拧在一起，动一个就可能牵出三个隐藏问题。别信“写完就能跑”，尤其是上线前那一次 route:cache，一定要单独验证几条关键嵌套路径的实际行为。
