Laravel Fortify对接SPA出现“Target class [guest] does not exist”错误

问题背景 #

用Docker部署的Laravel 10.10 + Fortify 1.18作为Nuxt 3 SPA的认证后端，登录时出现“缺少home路由”错误，注释app/Http/Kernel.php里的guest中间件别名后，又触发Target class [guest] does not exist的500错误。

解决步骤 #

1. 恢复guest中间件别名 #

打开app/Http/Kernel.php，把之前注释掉的guest别名恢复：

protected $middlewareAliases = [
    // ...其他别名
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
];

2. 修改RedirectIfAuthenticated中间件逻辑 #

打开app/Http/Middleware/RedirectIfAuthenticated.php，替换handle方法，让它适配SPA的JSON响应需求：

use Illuminate\Support\Facades\Auth;

public function handle(Request $request, Closure $next, ...$guards)
{
    $guards = empty($guards) ? [null] : $guards;

    foreach ($guards as $guard) {
        if (Auth::guard($guard)->check()) {
            // 针对SPA返回JSON响应，而非重定向
            if ($request->expectsJson()) {
                return response()->json([
                    'message' => '当前已处于登录状态'
                ], 403);
            }
            
            // 如果仍需保留传统重定向（可选），可以保留下面一行，否则删除
            // return redirect(RouteServiceProvider::HOME);
        }
    }

    return $next($request);
}

3. 配置Fortify为无视图模式（可选但推荐） #

打开config/fortify.php，设置views为false，确保Fortify始终返回JSON响应：

'views' => false,

原因分析 #

• 最初的“缺少home路由”错误，是因为默认的RedirectIfAuthenticated中间件在用户登录后会尝试重定向到home路由，但SPA后端没有定义该路由。
• 直接删除guest中间件别名会导致Fortify内部路由或自定义路由中使用guest中间件时，容器无法找到对应的类，从而触发500错误。
• 正确的做法是保留中间件别名，修改其响应逻辑，让它在SPA场景下返回JSON而非重定向，既解决重定向问题，又避免中间件缺失错误。

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