Laravel 8 基于Jetstream实现多认证时提示Auth guard [admin]未定义

1. 注册自定义Guard到Auth服务容器 #

你只定义了AdminStatefulGuard接口但没有绑定实现，打开app/Providers/AuthServiceProvider.php，在boot方法中添加如下代码：

use Illuminate\Contracts\Auth\Guard;
use Illuminate\Auth\SessionGuard;
use Illuminate\Support\Facades\Auth;

public function boot()
{
    $this->registerPolicies();

    // 注册admin guard实现
    Auth::extend('admin', function ($app, $name, array $config) {
        $guard = new SessionGuard(
            $name,
            Auth::createUserProvider($config['provider']),
            $app->make('session.store')
        );
        // 绑定Guard依赖
        $guard->setCookieJar($app->make('cookie'));
        $guard->setDispatcher($app->make('events'));
        $guard->setRequest($app->refresh('request', $guard, 'setRequest'));
        return $guard;
    });
}

同时检查AdminStatefulGuard.php顶部是否导入了Guard的命名空间：

use Illuminate\Contracts\Auth\Guard;

2. 注册自定义Fortify服务提供者 #

打开config/app.php，找到providers数组，确保你自己实现的FortifyServiceProvider已经注册，放在原生Fortify服务提供者后面：

'providers' => [
    // 其他服务提供者...
    Laravel\Fortify\FortifyServiceProvider::class,
    App\Providers\FortifyServiceProvider::class, // 必须添加这行
],

3. 校验管理员路由中间件配置 #

确保你管理员相关路由使用了对应的admin守卫中间件，示例路由配置如下：

// 管理员未登录可访问的路由
Route::group(['prefix' => 'admin', 'middleware' => ['guest:admin']], function(){
    Route::get('login', [\App\Http\Controllers\AdminController::class, 'loginForm'])->name('admin.login');
    Route::post('login', [\App\Http\Controllers\AdminController::class, 'store']);
});
// 管理员登录后可访问的路由
Route::group(['prefix' => 'admin', 'middleware' => ['auth:admin']], function(){
    Route::post('logout', [\App\Http\Controllers\AdminController::class, 'destroy'])->name('admin.logout');
    // 其他后台路由...
});

4. 全量清理项目缓存 #

执行如下命令清理所有缓存，避免旧配置残留：

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

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