Laravel自定义HasPermission中间件参数不足错误排查求助

错误根源 #

你的HasPermission中间件handle方法要求3个参数（$request、$next、$permissions），但使用时仅传递了前两个，触发报错。具体问题点：

• 路由组直接调用HasPermission中间件，未传入权限参数
• 控制器内尝试的中间件传参语法不符合Laravel规范

具体修复步骤 #

1. 确认Kernel.php的中间件别名配置 #

确保app/Http/Kernel.php的$routeMiddleware数组中已正确注册中间件别名（你控制器里用了permission:前缀，所以别名需设为permission）：

protected $routeMiddleware = [
    // ... 其他中间件
    'permission' => \App\Http\Middleware\HasPermission::class,
];

2. 修正路由配置 #

移除路由组上的HasPermission中间件（该中间件必须传参，无法全局挂载到路由组），修改后的路由：

Route::get('/usermgmt/users', [App\Http\Controllers\UserController::class, 'index'])->name('usermgmt.users');
Route::resource('users', UserController::class);
Route::get('add-user', [App\Http\Controllers\UserController::class, 'create'])->name('usermgmt.users.create');
Route::delete('users/{user}',[App\Http\Controllers\UserController::class, 'destroy'])->name('users.destroy');
Route::get('users/{user}/edit', [App\Http\Controllers\UserController::class, 'edit'])->name('usermgmt.users.edit');

3. 控制器中间件语法修正 #

你最初的控制器中间件写法是正确的，无需修改：

public function __construct() {
    $this->middleware('permission:usermgmt.users|usermgmt.users.create|usermgmt.users.edit|users.delete', ['only' => ['index','store']]);
    $this->middleware('permission:usermgmt.users.create', ['only' => ['create','store']]);
    $this->middleware('permission:usermgmt.users.edit', ['only' => ['edit','update']]);
    $this->middleware('permission:users.delete', ['only' => ['destroy']]);
}

如果想用类名直接传参，正确语法是：

$this->middleware(
    HasPermission::class . ':usermgmt.users|usermgmt.users.create|usermgmt.users.edit|users.delete',
    ['only' => ['index','store']]
);

4. 修复中间件内的Spatie方法调用 #

Spatie权限包的权限校验方法是hasPermissionTo，不是hasPermission，修改中间件代码：

public function handle($request, Closure $next,$permissions)
{
    $permissions_array = explode('|', $permissions);
    foreach($permissions_array as $permission){
        if (!$request->user()->hasPermissionTo($permission)){
            return redirect()->back();                        
        }
    }    
    return $next($request);
}

验证 #

完成修改后，执行php artisan route:clear清除路由缓存，重新访问页面即可解决参数不足的错误，权限校验逻辑也能正常运行。

内容的提问来源于stack exchange，提问作者99Chop