Laravel 8集成Passport搭建OAuth2服务Postman测试报客户端认证失败如何解决

• 核心配置错误：User模型引入的HasApiTokens trait是Laravel Sanctum组件提供的，不是Passport要求的同名trait，Passport依赖自身的HasApiTokens完成OAuth2流程的用户关联校验，引入错误会直接导致客户端验证失败
• 自定义密钥路径不生效：你在AuthServiceProvider中指定了密钥加载路径Passport::loadKeysFrom(__DIR__.'/../secrets/oauth')，如果该目录下没有正确生成Passport的公私钥文件oauth-private.key、oauth-public.key，会导致客户端签名校验失败
• 回调地址不匹配：你创建OAuth2客户端时填写的redirect_uri参数，必须和授权请求、令牌兑换请求中提交的redirect_uri完全一致，哪怕多一个末尾斜杠都会触发校验失败
• 请求参数不符合要求：令牌兑换请求的grant_type参数必须明确指定为authorization_code，如果参数缺失或值错误也会抛出该错误
• 客户端类型不匹配：如果你创建的不是授权码类型客户端，而是密码授权、客户端凭证类型的客户端，无法走授权码兑换令牌的流程

1. 替换User模型的trait引入

// 移除原有Sanctum的trait引用
// use Laravel\Sanctum\HasApiTokens;
// 替换为Passport提供的HasApiTokens
use Laravel\Passport\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;
    // 其余原有代码保持不变
}

2. 生成正确路径的密钥文件
   如果app/secrets/oauth目录下没有公私钥文件，执行以下命令生成：

php artisan passport:keys --path=./app/secrets/oauth

生成后给对应目录和文件设置读权限，保证Web服务运行用户可以正常读取文件。
3. 校验客户端和请求参数

• 创建授权码客户端时填写的回调地址必须和请求中使用的http://127.0.0.1:8000/authorize/response完全一致
• 令牌兑换请求必须提交以下必填参数：

  参数名	参数值
  grant_type	authorization_code
  client_id	你的客户端ID（你的场景为2）
  client_secret	创建客户端时生成的密钥
  redirect_uri	和授权请求完全一致的回调地址
  code	拿到的授权code

4. 清理框架缓存

php artisan config:clear
php artisan route:clear

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