Laravel9 Socialite对接Twitter登录获取临时凭证报401错误

触发的异常信息：

League\OAuth1\Client\Credentials\CredentialsException Received HTTP status code [401] with message "{"errors":[{"code":32,"message":"Could not authenticate you."}]}" when getting temporary credentials.

这个错误属于OAuth1.0a流程签名校验不通过，按以下顺序排查修复即可：

• 优先检查第三方Twitter驱动加载问题：你已经安装了socialiteproviders/twitter ^4.1，但大概率没注册对应的事件监听，导致程序还是走Socialite自带的旧版Twitter驱动，和当前Twitter(X)开放平台接口不兼容。
  打开app/Providers/EventServiceProvider.php，在$listen数组中添加如下配置，其他原有监听项保持不变：

  protected $listen = [
      \SocialiteProviders\Manager\SocialiteWasCalled::class => [
          \SocialiteProviders\Twitter\TwitterExtendSocialite::class.'@handle',
      ],
      // 其他原有事件监听不要动
  ];
  

  修改完成后执行以下命令清除配置缓存：

  php artisan config:clear
  php artisan cache:clear
  

• 核对密钥正确性：Twitter开发者后台同时提供OAuth1.0a和OAuth2.0两套密钥，Socialite的Twitter驱动走OAuth1.0a流程，.env里的TWITTER_CLIENT_ID要填OAuth1.0a的API Key（也叫Consumer Key），TWITTER_CLIENT_SECRET要填对应的API Key Secret，不要填成OAuth2.0的Client ID/Secret，也不要填Bearer Token，复制的时候前后不要带空格。
• 核对Twitter开发者后台配置：
  • 进入应用的User authentication settings页，确认应用类型选的是Web App, Automated App or Bot
  • 回调地址精确填写https://testsite.com/auth/twitter/callback，协议头（http/https）、域名、路径要和项目config/services.php里的redirect配置完全一致，末尾不要加斜杠，不要带多余参数
  • 应用权限至少选Read级别，不能选纯写入权限
  • Website URL项不要留空，填你的项目域名即可
• 校准本地服务器时间：OAuth1.0a签名会校验请求时间戳，如果你本地开发机时间和Twitter服务器时间差超过5分钟，签名会直接判定无效。Windows开系统自动时间同步，Mac/Linux执行系统时间同步命令校准即可。
• 排查本地网络SSL问题：如果本地环境的CA证书过期，请求Twitter接口时会出现签名异常，执行以下命令测试连通性：

  curl -I https://api.twitter.com
  

  正常会返回200状态码，如果报SSL证书错误，更新本地系统的CA证书包即可。

额外逻辑修复建议 #

你现有控制器代码存在隐患：Twitter默认不会返回用户邮箱，直接用email作为updateOrCreate的匹配条件会因为空值触发数据库报错，建议把用户创建逻辑改成用twitter_id作为唯一匹配键：

$finduser = User::where('twitter_id', $user->id)->first();
if($finduser){
    Auth::login($finduser);
    return redirect()->intended('/home');
}else{
    $newUser = User::updateOrCreate(['twitter_id' => $user->id],[
        'name' => $user->name,
        'username'=> $user->nickname,
        'uid' => rand(9,999999999)+time(),
        'password' => encrypt('123456dummy')
    ]);
    Auth::login($newUser);
    return redirect()->intended('/home');
}

如果需要获取用户邮箱，要单独去Twitter开发者后台申请邮箱访问权限，否则$user->email会一直返回null。

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