Laravel 11.x使用Socialite实现Google认证报错：目标类[google.auth]不存在

问题原因 #

Laravel 11 重构了中间件注册逻辑，移除了旧版本在 Kernel.php 中定义路由中间件别名的方式，改为在 bootstrap/app.php 中统一配置。你仍使用旧版本的注册方式，导致框架无法识别 google.auth 别名对应的中间件类。

解决步骤 #

1. 清理 Kernel.php 中的无效注册 #

打开 app/Http/Kernel.php，删除 $routeMiddleware 数组内的以下代码：

'google.auth' => \App\Http\Middleware\CheckGoogleAuth::class,

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

打开 bootstrap/app.php，在应用配置链中添加 withMiddleware 方法，注册你的中间件别名：

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

3. 验证中间件文件完整性 #

确认 CheckGoogleAuth.php 文件位于 app/Http/Middleware 目录下，且命名空间为 App\Http\Middleware，与代码定义一致。

4. 清除框架缓存（推荐） #

执行以下命令清除缓存，避免缓存导致的配置不生效：

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

额外优化建议 #

你的 CheckGoogleAuth 中间件当前仅检查用户是否登录，未验证是否通过Google认证。若需确保用户通过Google登录，可修改中间件逻辑：

public function handle(Request $request, Closure $next)
{
    // 检查用户已登录且存在google_id字段
    if (!Auth::check() || is_null(Auth::user()->google_id)) {
        return redirect('/auth/google');
    }

    return $next($request);
}

同时确认 .env 文件中的Google配置项：

GOOGLE_CLIENT_ID=你的Google客户端ID
GOOGLE_CLIENT_SECRET=你的Google客户端密钥
GOOGLE_REDIRECT_URL=https://你的域名/auth/google/callback

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