Laravel自定义中间件添加到路由组提示类不存在的问题

看起来你遇到的问题是Laravel无法识别路由组中引用的自定义中间件，即使执行了常见的缓存清除操作也没解决。别担心，我们一步步排查并解决：

1. 正确注册中间件别名（最常见的原因） #

你当前把自定义中间件加到了Kernel.php的全局中间件数组$middleware里，但路由组中使用的是中间件的"别名"，这需要先在$routeMiddleware数组中单独注册。

打开app/Http/Kernel.php，找到$routeMiddleware数组，添加你的中间件别名：

protected $routeMiddleware = [
    // 保留其他默认中间件，比如这些
    'auth' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
    // 添加你的中间件别名
    'admin.role' => \App\Http\Middleware\CheckUserAdminRole::class,
];

然后修改路由组，使用这个别名：

Route::group(['namespace' => 'Dashboard', 'middleware' => ['auth:web','admin.role'], 'prefix' => 'dashboard'], function () {
    $this->group(['prefix' => 'administrator'], function () {
        $this->get('panel', 'AdminController@index');
    });
});

2. 或者直接使用完整类名（跳过别名注册） #

如果不想配置别名，也可以在路由组中直接指定中间件的完整命名空间路径：

Route::group(['namespace' => 'Dashboard', 'middleware' => ['auth:web',\App\Http\Middleware\CheckUserAdminRole::class], 'prefix' => 'dashboard'], function () {
    $this->group(['prefix' => 'administrator'], function () {
        $this->get('panel', 'AdminController@index');
    });
});

3. 检查文件和类名的一致性 #

确保你的中间件文件名为CheckUserAdminRole.php（注意大小写，Linux系统对文件名大小写敏感），并且文件内的命名空间和类名完全匹配：

namespace App\Http\Middleware;
use Closure;

class CheckUserAdminRole {
    // ... 你的handle方法
}

4. 重新执行缓存清除命令（带优化参数） #

虽然你已经执行过，但加上自动加载优化参数可能会解决类加载问题：

php artisan route:clear
php artisan cache:clear
php artisan config:clear
composer dump-autoload -o

额外小优化：简化你的中间件逻辑 #

你原中间件里有重复的auth()->check()判断，可以简化成：

public function handle($request, Closure $next) {
    if (auth()->check() && !auth()->user()->hasRole('admin')) {
        auth()->logout();
        return redirect(route('system.messages','userIsNotAdmin'));
    }
    return $next($request);
}

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