如何解决Laravel中JWT认证时报User实例不符合JWTSubject的错误

修复方案 #

核心根因 #

你的User模型仅导入了JWTSubject接口的命名空间，未在类声明处绑定实现该接口，导致框架认为App\Models\User没有满足JWTAuth要求的接口契约，触发类型错误。

操作步骤 #

1. 修正User模型的接口实现

修改app/Models/User.php的类定义行：

// 原有错误代码
class User extends Authenticatable
// 替换为正确代码
class User extends Authenticatable implements JWTSubject

你已经在模型内写好了getJWTIdentifier和getJWTCustomClaims两个接口要求的方法，补充implements声明即可满足接口契约要求。

2. 清空Laravel缓存

执行以下命令清除所有旧缓存，确保框架加载最新代码配置：

php artisan optimize:clear

如果是生产环境可以仅清理配置缓存：

php artisan config:clear

3. 可选校验配置

确认config/auth.php中的用户提供者配置指向正确的User模型：

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],
],

验证效果 #

操作完成后重启服务，再次通过Postman调用登录接口即可正常生成JWT token。

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