Laravel 11路由中间件报错：Target class [role]不存在但已定义

核心原因 #

Laravel 11移除了传统的app/Http/Kernel.php配置文件，改用bootstrap/app.php统一管理中间件。你手动创建的Kernel.php不会被框架加载，导致注册的role中间件别名完全不生效。

具体修复步骤 #

1. 删除无效的自定义Kernel.php #

直接删除你手动创建的app/Http/Kernel.php文件，避免干扰框架默认配置逻辑。

2. 在bootstrap/app.php中注册中间件别名 #

打开项目根目录下的bootstrap/app.php，找到应用配置代码块，添加withMiddleware回调注册role别名：

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        // 注册自定义中间件别名
        $middleware->alias([
            'role' => \App\Http\Middleware\RoleMiddleware::class,
        ]);
    })
    ->create();

3. 完善RoleMiddleware的基础代码 #

确保app/Http/Middleware/RoleMiddleware.php包含正确的命名空间和必要的类引用：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class RoleMiddleware
{
    public function handle($request, Closure $next, $role)
    {   
        $user = Auth::user();
        if (!Auth::check() || !$user->hasRole($role)) {
            abort(403, 'Unauthorized');
        }
        return $next($request);
    }
}

4. 清除框架缓存 #

运行以下命令清除所有缓存，确保新配置立即生效：

php artisan optimize:clear

完成以上步骤后，重新访问/admin路由，报错即可解决。

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