OAuth 2.0授权码兑换访问令牌：PHP代码HTTP 500错误排查求助

看起来你在兑换OAuth授权码时碰到了棘手的500错误，我帮你梳理几个排查方向，应该能找到问题所在：

• 先补全并校验cURL请求的核心参数
  你的代码里CURLOPT_ENCODING =>...没写完，而OAuth令牌请求有几个必填参数绝对不能少：grant_type=authorization_code、获取到的授权码code、你的client_id、client_secret，还有和注册时完全一致的redirect_uri。少一个都可能触发服务器内部错误，给你补全后的参考代码：

  <?php
  // 从当前URL获取授权码（确保回调URL正确带了code参数）
  $authCode = isset($_GET['code']) ? $_GET['code'] : '';
  if (empty($authCode)) {
      die("授权码不存在，请检查回调URL");
  }
  
  $curl = curl_init();
  $postParams = array(
      'grant_type' => 'authorization_code',
      'code' => $authCode,
      'client_id' => '你的真实客户端ID',
      'client_secret' => '你的真实客户端密钥',
      'redirect_uri' => '你在Shoeboxed注册的回调URL'
  );
  
  curl_setopt_array($curl, array(
      CURLOPT_URL => "https://id.shoeboxed.com/oauth/token",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 30,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_POSTFIELDS => http_build_query($postParams),
      CURLOPT_HTTPHEADER => array(
          "Content-Type: application/x-www-form-urlencoded"
      ),
  ));
  
  $response = curl_exec($curl);
  // 捕获cURL请求本身的错误
  $curlErr = curl_error($curl);
  // 获取HTTP响应码，方便判断是服务器问题还是请求问题
  $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  
  curl_close($curl);
  
  if ($curlErr) {
      echo "cURL请求错误: " . $curlErr;
  } else {
      echo "HTTP响应码: " . $httpCode . "<br>";
      echo "服务器返回内容: " . $response;
  }
  ?>
  

• 开启错误日志，拿到具体报错信息
  HTTP 500只是泛泛的服务器错误，你得拿到具体细节：

  • 上面的代码已经加了curl_error和CURLINFO_HTTP_CODE，可以帮你判断是请求发不出去，还是服务器返回的问题；
  • 同时查看你的PHP服务器错误日志（比如Apache的error.log、Nginx的error.log，或者虚拟主机面板里的错误日志），里面会记录PHP代码的语法错误、未定义变量等具体问题，这是排查500错误的关键。

• 验证授权码和回调URL的有效性

  • 授权码有效期通常很短（比如10分钟），如果是很久之前获取的，先重新走授权流程拿新的授权码；
  • 回调URL必须和你在Shoeboxed开发者平台注册的完全一致，包括HTTP/HTTPS、路径、甚至末尾的斜杠，哪怕差一点都可能导致服务器拒绝请求。

• 用工具先测试请求是否可行
  抛开PHP代码，先用curl命令行手动构造请求，比如：

  curl -X POST "https://id.shoeboxed.com/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=你的授权码&client_id=你的ID&client_secret=你的密钥&redirect_uri=你的回调URL"
  

  如果这个命令能成功拿到令牌，说明问题出在PHP代码的参数传递或cURL配置上；如果还是返回500，那可以联系Shoeboxed的技术支持，提供你的请求参数，让他们排查服务器端的问题。

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