如何实现Laravel中users与students双用户表的多认证登录？

这个问题是Laravel多用户认证的典型场景，你已经完成了核心的守卫与Provider配置，只需要调整登录逻辑，显式指定对应守卫就能实现两个表独立登录，无需修改全局默认配置。以下是具体实现步骤：

一、保留现有auth.php配置不变 #

你的当前配置已经正确定义了两个用户Provider和对应守卫，不需要修改defaults节点（全局默认守卫只是兜底选项，我们会在登录时主动指定守卫）：

// config/auth.php
'auth' => [
    'defaults' => [
        'guard' => 'api',
        'passwords' => 'users',
    ],
    'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        'api' => [
            'driver' => 'jwt',
            'provider' => 'users',
            'hash' => false,
        ],
        'student' => [
            'driver' => 'session',
            'provider' => 'students',
        ]
    ],
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\User::class,
        ],
        'students' => [
            'driver' => 'eloquent',
            'model' => App\Student::class,
        ]
    ],
    // 可选：如果需要支持学生密码重置，添加对应的broker
    'passwords' => [
        'users' => [
            'provider' => 'users',
            'table' => 'password_resets',
            'expire' => 60,
        ],
        'students' => [
            'provider' => 'students',
            'table' => 'password_resets',
            'expire' => 60,
        ],
    ],
]

二、为不同用户表编写独立登录逻辑 #

1. Web端（Session认证） #

创建学生专属的登录控制器，或者在现有控制器中添加学生登录方法，显式使用student守卫：

// app/Http/Controllers/Auth/StudentLoginController.php
namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class StudentLoginController extends Controller
{
    public function showLoginForm()
    {
        return view('auth.student-login'); // 学生登录页面视图
    }

    public function login(Request $request)
    {
        // 验证登录参数
        $this->validate($request, [
            'username' => 'required|string',
            'password' => 'required|string|min:6',
        ]);

        // 使用student守卫进行认证
        if (Auth::guard('student')->attempt([
            'username' => $request->username,
            'password' => $request->password
        ])) {
            // 认证成功，跳转学生专属页面
            return redirect()->intended('/student/dashboard');
        }

        // 认证失败，返回登录页并提示错误
        return back()
            ->withInput($request->only('username'))
            ->withErrors(['username' => '用户名或密码错误']);
    }
}

添加学生登录路由：

// routes/web.php
Route::get('/student/login', [App\Http\Controllers\Auth\StudentLoginController::class, 'showLoginForm'])->name('student.login');
Route::post('/student/login', [App\Http\Controllers\Auth\StudentLoginController::class, 'login']);

普通用户的登录逻辑保持默认即可，它会自动使用web守卫（全局默认的web守卫对应users表）。

2. API端（JWT认证） #

如果需要支持学生的JWT登录，建议新增一个student_api守卫（避免和默认api守卫冲突）：

// config/auth.php -> guards节点
'student_api' => [
    'driver' => 'jwt',
    'provider' => 'students',
    'hash' => false,
],

然后在API控制器中编写两个独立的登录方法：

// app/Http/Controllers/Api/AuthController.php
namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class AuthController extends Controller
{
    // 普通用户API登录（使用api守卫）
    public function userLogin(Request $request)
    {
        $credentials = $request->only('username', 'password');

        if ($token = Auth::guard('api')->attempt($credentials)) {
            return $this->respondWithToken($token);
        }

        return response()->json(['error' => 'Unauthorized'], 401);
    }

    // 学生API登录（使用student_api守卫）
    public function studentLogin(Request $request)
    {
        $credentials = $request->only('username', 'password');

        if ($token = Auth::guard('student_api')->attempt($credentials)) {
            return $this->respondWithToken($token, 'student_api');
        }

        return response()->json(['error' => 'Unauthorized'], 401);
    }

    // JWT响应辅助方法
    protected function respondWithToken($token, $guard = 'api')
    {
        return response()->json([
            'access_token' => $token,
            'token_type' => 'bearer',
            'expires_in' => Auth::guard($guard)->factory()->getTTL() * 60
        ]);
    }
}

添加API登录路由：

// routes/api.php
Route::post('/login', [App\Http\Controllers\Api\AuthController::class, 'userLogin']);
Route::post('/student/login', [App\Http\Controllers\Api\AuthController::class, 'studentLogin']);

三、关键注意事项 #

• 确保Student模型继承Illuminate\Foundation\Auth\User类，若使用JWT需实现Tymon\JWTAuth\Contracts\JWTSubject接口：

// app/Student.php
namespace App;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Tymon\JWTAuth\Contracts\JWTSubject;

class Student extends Authenticatable implements JWTSubject
{
    // ... 模型其他代码

    public function getJWTIdentifier()
    {
        return $this->getKey();
    }

    public function getJWTCustomClaims()
    {
        return [];
    }
}

• 不要修改全局defaults配置来切换用户表，这会导致全局只能使用一种认证；正确做法是在需要时显式指定守卫（如Auth::guard('student')->xxx）。

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