Laravel 11使用spatie/laravel-permission报错：Target class [role]不存在

问题根源 #

Laravel 11移除了传统的app/Http/Kernel.php文件，中间件别名需要在bootstrap/app.php中注册，你当前未完成这一步，导致框架无法识别role中间件别名；另外路由文件存在语法缺失，也可能引发异常。

解决步骤 #

1. 修复路由文件语法错误 #

打开routes/api.php，补充缺失的闭合括号：

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
use App\Http\Controllers\AuthController;
use App\Http\Controllers\UserController;

Route::middleware('auth:api')->group(function () {

    Route::middleware('role:admin')->group(function () {
        Route::apiResource('users', UserController::class); 
    }); // 补充group闭合
}); // 补充外层group闭合

2. 注册Spatie中间件别名 #

打开bootstrap/app.php，在withMiddleware回调中添加中间件别名映射：

use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        // 注册Spatie Permission的中间件别名
        $middleware->alias([
            'role' => \Spatie\Permission\Middlewares\RoleMiddleware::class,
            'permission' => \Spatie\Permission\Middlewares\PermissionMiddleware::class,
            'role_or_permission' => \Spatie\Permission\Middlewares\RoleOrPermissionMiddleware::class,
        ]);
    })
    ->withExceptions(function (Exceptions $exceptions) {
        // 保留原有异常配置
    })->create();

3. 清除缓存确保配置生效 #

执行以下命令清除路由和配置缓存：

php artisan route:clear
php artisan config:clear

可选：直接使用中间件类（无需别名） #

若不想注册别名，可直接使用中间件类，注意参数传递格式：

use Spatie\Permission\Middlewares\RoleMiddleware;

Route::middleware('auth:api')->group(function () {
    Route::middleware([RoleMiddleware::class . ':admin'])->group(function () {
        Route::apiResource('users', UserController::class); 
    });
});

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