Laravel 6+Passport使用自定义字段与实体实现API认证问题

看起来你踩了一个常见的Passport认证误区——Passport的TokenGuard（也就是你配置的api guard使用的driver）并不支持attempt()或带参数的check()方法，这就是你遇到"未知方法"提示的原因。下面一步步帮你实现用idnumber代替默认字段登录的需求：

第一步：修正你的OtherUser模型 #

Passport需要模型提供两个关键方法来支持自定义字段认证，在你的OtherUser实体中添加以下代码：

namespace App\Domain\Entities;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Laravel\Passport\HasApiTokens;

class OtherUser extends Authenticatable
{
    use HasApiTokens;

    // 允许批量赋值的字段，根据你的实际需求调整
    protected $fillable = ['idnumber', 'password'];

    // 重写Passport的用户查找逻辑，用idnumber代替默认的email/username
    public function findForPassport($identifier)
    {
        return $this->where('idnumber', $identifier)->first();
    }

    // 验证密码是否匹配
    public function validateForPassportPasswordGrant($password)
    {
        return \Hash::check($password, $this->password);
    }
}

第二步：替换控制器中的认证逻辑 #

因为TokenGuard的check()方法只是验证当前请求是否携带有效令牌，不是用来验证登录凭证的。你需要手动验证用户信息，然后生成Passport令牌：

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use App\Domain\Entities\OtherUser;

public function login(Request $request)
{
    // 先验证输入的合法性
    $request->validate([
        'idnumber' => 'required',
        'password' => 'required',
    ]);

    // 根据idnumber查找用户
    $user = OtherUser::where('idnumber', $request->idnumber)->first();

    // 验证用户是否存在，密码是否正确
    if (!$user || !Hash::check($request->password, $user->password)) {
        return response()->json([
            'message' => 'Invalid idnumber or password'
        ], 401);
    }

    // 生成个人访问令牌
    $accessToken = $user->createToken('API Login Token')->accessToken;

    return response()->json([
        'access_token' => $accessToken,
        'token_type' => 'Bearer',
        'user' => $user
    ]);
}

额外方案：使用Passport密码授权端点 #

如果你想复用Passport自带的/oauth/token端点，只需要在请求时把username参数传为你的idnumber即可（因为我们已经重写了findForPassport方法，Passport会自动用idnumber查找用户）。示例请求：

POST /oauth/token
Content-Type: application/json

{
    "grant_type": "password",
    "client_id": "你的密码客户端ID",
    "client_secret": "你的密码客户端密钥",
    "username": "用户的idnumber",
    "password": "用户的密码",
    "scope": ""
}

最后确认你的配置 #

你当前的auth.php配置是正确的，确保OtherUser模型的命名空间和配置中的一致即可。

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