Laravel 11报错Target class [admin]不存在，求助排查解决

我是编程新手，在Laravel 11项目开发中遇到错误Target class [admin] does not exist，这个问题卡住了项目进度。需要说明的是，创建项目时Kernel.php没有自动生成，我手动添加了这个文件。我已经检查过拼写和文件存放路径，确认没问题，但问题还是没解决。

相关代码 #

web.php #

Route::get('/', function () {
return view('welcome');
});

Route::get('/dashboard', function () {
return view('back.dashboard');
})->middleware(['auth', 'verified', 'admin'])->name('dashboard');

Route::middleware('auth')->group(function () {
Route::get('/profile', [ProfileController::class, 'edit'])->name('profile.edit');
Route::patch('/profile', [ProfileController::class, 'update'])->name('profile.update');
Route::delete('/profile', [ProfileController::class, 'destroy'])->name('profile.destroy');
});

Kernel.php #

protected $middlewareAliases = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'auth.session' => \Illuminate\Session\Middleware\AuthenticateSession::class,
    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
    'precognitive' => \Illuminate\Foundation\Http\Middleware\HandlePrecognitiveRequests::class,
    'signed' => \App\Http\Middleware\ValidateSignature::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,

    'admin' => \App\Http\Middleware\Admin::class,
    'checkRole' => \App\Http\Middleware\CheckRole::class,
];

Admin.php #

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Symfony\Component\HttpFoundation\Response;

class Admin extends Middleware
{
    /**
     * Handle an incoming request.
     *
     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
     */
    public function handle(Request $request, Closure $next): Response
    {
        $user = Auth::user();

        if ($user && str_contains($user->role, 'admin')){
            return $next($request);
        }

        abort(403, 'Accès non autorise');

    }
}

问题排查与解决步骤 #

1. 补全Kernel.php的完整结构 #

Laravel 11的Kernel.php必须位于app/Http/目录下，且需要继承基础HttpKernel类，完整结构如下：

<?php

namespace App\Http;

use Illuminate\Foundation\Http\Kernel as HttpKernel;

class Kernel extends HttpKernel
{
    protected $middlewareAliases = [
        // 你原来的别名配置代码
    ];
}

如果你的手动添加文件缺少上述结构，Laravel无法识别中间件别名。

2. 修正Admin中间件的继承问题 #

你的Admin类继承了Middleware，但未正确引入对应命名空间的父类。可以直接去掉继承（自定义中间件不需要强制继承父类，只要实现handle方法即可）：

// 修改Admin.php的类定义
class Admin
{
    // 保持原handle方法不变
}

或者正确引入Laravel的基础Middleware类：

use Illuminate\Routing\Middleware\Middleware;

class Admin extends Middleware
{
    // ... 原代码不变
}

3. 清理Laravel缓存 #

手动修改配置或中间件后，必须清理框架缓存才能让新配置生效：

php artisan config:clear
php artisan route:clear
php artisan cache:clear

4. 再次核对文件路径与命名 #

• 确认Admin.php文件在app/Http/Middleware/目录下，文件名首字母大写（严格区分大小写）。
• 命名空间namespace App\Http\Middleware;必须与文件路径完全对应。

内容的提问来源于stack exchange，提问作者Romain Du Boullay