Laravel 5.4使用Socialite集成Facebook登录报错：授权码已使用

这是Facebook OAuth流程里很常见的偶发问题，我之前在类似的Laravel项目中也碰到过，给你几个实用的排查和解决方向：

• 避免重复提交/刷新回调页面
  授权码（authorization code）本身是一次性的，一旦用来换取access token就会失效。如果用户在回调页面刷新，或者前端按钮重复点击导致多次发起授权请求，就会触发这个错误。你可以：

  • 在回调处理完成后，立即重定向到应用内部页面（比如用redirect()->intended('/dashboard')），不要停留在回调路由页面；
  • 给登录按钮加上防重复点击逻辑（比如点击后禁用按钮），避免用户短时间内多次触发授权跳转。

• 清理Socialite会话临时数据
  Socialite会把授权流程中的临时数据存在会话里，如果会话没有正常清空，可能导致后续请求复用旧的授权码。你可以在发起Facebook授权跳转的路由里，先清空相关会话数据：

  Route::get('login/facebook', function () {
      // 清空之前的Socialite会话数据
      session()->forget('socialite');
      return Socialite::driver('facebook')->redirect();
  });
  

• 检查Facebook应用配置与Socialite版本

  • 确认Facebook应用后台的「Valid OAuth Redirect URIs」设置完全正确，和你项目中的回调路由一致，不要有多余或错误的URI；
  • Laravel 5.4对应的Socialite版本是^2.0，建议更新到该分支的最新版本（执行composer update laravel/socialite），旧版本可能存在OAuth流程的bug，导致授权码重复使用的问题。

• 捕获异常并友好处理
  在回调方法中主动捕获这个特定异常，给用户友好提示而不是直接抛出错误页面：

  public function handleFacebookCallback()
  {
      try {
          $user = Socialite::driver('facebook')->user();
          // 后续的用户创建/登录逻辑
      } catch (\GuzzleHttp\Exception\ClientException $e) {
          $errorData = json_decode($e->getResponse()->getBody()->getContents(), true);
          if (isset($errorData['error']['code']) && $errorData['error']['code'] === 100) {
              return redirect()->route('login')->withErrors(['login' => '授权已过期或重复，请重新尝试登录']);
          }
          // 其他异常继续抛出
          throw $e;
      }
  }
  

• 排查服务器缓存/会话问题
  如果你的项目使用了CDN、反向代理或者服务器端缓存，确保回调路由没有被缓存，并且会话（session）配置正常，不会出现会话数据共享、丢失或者重复读取的情况。比如，确认Laravel的session驱动是合适的（比如file或者redis，不要用数组驱动在生产环境）。

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