laravel路由统一前缀必须用route::group(['prefix' => 'xxx'], fn() => {...})，单独在单个路由调用prefix无效；prefix与middleware需同在group数组参数中声明，不可链式调用；嵌套时prefix拼接、middleware合并，调试务必用php artisan route:list验证。
怎么给 Laravel 路由加统一前缀
用 prefix 就行，但得套在 Route::group() 里，单独给单个路由加没意义。它不是修饰符，是分组行为的配置项。
常见错误是写成 Route::get('/admin/users', ...)->prefix('admin') —— 这根本不会生效，prefix 只对 Route::group() 有效。
-
Route::group(['prefix' => 'api'], function () { ... })：所有子路由自动带/api - 前缀会拼接，
prefix => 'v1'+get('users')→ 实际路径是/v1/users - 别在 prefix 里加开头或结尾斜杠（比如
'/api/'），Laravel 会自动处理，多加容易导致双斜杠或 404
如何同时绑定中间件和前缀
中间件和前缀必须一起塞进 Route::group() 的第一个参数数组里，不能分开调用。顺序无关，但漏掉任何一个键都会让对应功能失效。
典型翻车现场：Route::group(['prefix' => 'admin'])->middleware('auth')->group(...) —— 这样 middleware 不生效，因为 ->middleware() 是链式调用，但 Route::group() 返回的是静态构建器，不支持这种链式写法。
- 正确写法：
Route::group(['prefix' => 'admin', 'middleware' => 'auth'], function () { ... }) - 多个中间件写成数组：
'middleware' => ['auth', 'can:manage-users'] - 如果中间件需要参数（比如
throttle:60,1），直接当字符串写进数组，不用额外转义
为什么 RouteServiceProvider 的 group 写法看起来不一样
你在 app/Providers/RouteServiceProvider.php 里看到的 Route::middleware('web')->group(base_path('routes/web.php'))，其实是 Laravel 8+ 引入的「文件式分组」语法，本质还是 Route::group()，只是把闭包换成了文件路径。
它和手动写闭包的区别在于加载时机和作用域：文件内定义的路由，$router 实例已预置好中间件和命名空间，但 prefix 仍需显式声明；而闭包方式更灵活，适合动态条件分支。
- 文件式写法不自动继承外层 prefix，
Route::prefix('api')->group(base_path('routes/api.php'))才有效 - 别在
web.php里重复写Route::middleware('web')—— 它已经被 RouteServiceProvider 加过了，重复会导致中间件执行两次 - 如果路由文件里用了
use导入类，确保闭包函数里也导入，文件式加载不共享命名空间上下文
嵌套路由组的坑：中间件叠加和 prefix 拼接
可以嵌套 Route::group()，但 prefix 是字符串拼接，中间件是数组合并，行为不一致，容易误判实际效果。
比如外层 prefix => 'v1' + 内层 prefix => 'users'，结果是 /v1/users；但外层 middleware => ['auth'] + 内层 middleware => ['throttle']，最终两个中间件都会执行，不是覆盖。
- 嵌套时 prefix 会连起来，但空字符串、null 或 false 会被忽略，
prefix => null不报错也不生效 - 中间件数组去重靠 PHP 原生行为，相同字符串只执行一次，但
'auth:sanctum'和'auth:api'算不同中间件 - 调试时用
php artisan route:list看实际生成的中间件列和 URI，比猜靠谱得多
