在 laravel 路由中，可通过全限定类名（fqcn）注册中间件并同时传入参数，语法为 middlewareclass::class . ':param1,param2'，适用于自定义中间件的灵活配置。
在 laravel 路由中，可通过全限定类名（fqcn）注册中间件并同时传入参数，语法为 middlewareclass::class . ':param1,param2'，适用于自定义中间件的灵活配置。
Laravel 允许以两种方式为路由分配中间件：使用简写的中间件别名（如 'auth'）或直接使用全限定类名（FQCN）。当需要绕过中间件别名注册、或在动态场景中精确控制中间件实例时，FQCN 方式尤为实用。而若该中间件支持参数（例如用于权限检查的 role:admin,editor），你依然可以为其传递参数——只需将 Middleware::class 与参数部分用冒号 : 连接，并用英文逗号分隔多个参数。
例如，假设你有一个自定义中间件 App\Http\Middleware\EnsureUserHasRole，其 handle() 方法接收额外参数：
// app/Http/Middleware/EnsureUserHasRole.php
public function handle(Request $request, Closure $next, ...$roles)
{
if (! $request->user()?->hasAnyRole($roles)) {
abort(403, 'Unauthorized access.');
}
return $next($request);
}
你可在路由中这样使用其全限定类名并传参：
use App\Http\Middleware\EnsureUserHasRole;
Route::get('/dashboard', function () {
return view('dashboard');
})->middleware(EnsureUserHasRole::class . ':admin,super-admin');
✅ 注意事项：
- 参数必须是字符串形式，即使传递数字或布尔值，也需以字符串写入（如 ':1,true'），中间件内部需自行转换；
- Laravel 不会对 FQCN 中间件做自动参数解析优化，因此确保中间件构造函数无必需参数（否则会抛出反射异常），参数应全部通过 handle 方法接收；
- 若中间件已在 app/Http/Kernel.php 中注册了别名，优先使用别名可提升可读性；FQCN + 参数更适合一次性、非全局复用的场景；
- 多个中间件组合时，可链式调用 ->middleware(...)，或传入数组：->middleware([EnsureUserHasRole::class . ':admin', 'throttle:60,1'])。
综上，FQCN + 参数的组合既保持了 Laravel 的灵活性，又避免了全局中间件别名的耦合，是构建高内聚、低耦合路由逻辑的有效实践。
