使用Axios发送Post请求触发HTTP 500错误，请求排查代码问题

问题场景 #

调用eBay OAuth2接口刷新令牌时，Axios发送POST请求返回HTTP 500错误，相关代码和错误信息如下：

代码 #

async function getUserTokenByRefresh(refreshToken) {
    const encodedStr = base64Encode(`${process.env.EBAY_SANDBOX_APPID}:${process.env.EBAY_SANDBOX_CERTID}`);
    const auth = `Basic ${encodedStr}`;
    const options = {
        headers: {
            "Content-Type": "application/x-www-form-urlencoded",
            Authorization: auth
        }
    };
    const data = {
        grant_type: "refresh_token",
        refresh_token: refreshToken       
    };
    const testing = true;

    const url = testing
    ? "https://api.sandbox.ebay.com/identity/v1/oauth2/token"
    : "https://api.ebay.com/identity/v1/oauth2/token";
    
    try {
        const response = await axios.post(
            url,
            data,
            options
        );
        console.log(JSON.stringify(response));
    }
    catch (e) {
        console.log(JSON.stringify(e));
    }

}

错误信息 #

{
  "message": "Request failed with status code 500",
  "code": "ERR_BAD_RESPONSE",
  "status": 500
}

排查要点 #

• 请求数据格式不匹配：你设置了Content-Type: application/x-www-form-urlencoded，但直接传入JS对象data，Axios默认会把它序列化为JSON格式，导致服务端解析失败。解决方法是将data转为URL编码字符串：

  // 替换原data传递方式
  const response = await axios.post(
      url,
      new URLSearchParams(data).toString(),
      options
  );
  // 或者用qs库（需先安装）：import qs from 'qs'; 然后传qs.stringify(data)
  

• Base64编码验证：确认base64Encode函数能正确生成符合Basic Auth规范的编码（无换行、编码字符串正确），同时检查环境变量EBAY_SANDBOX_APPID和EBAY_SANDBOX_CERTID是否正确加载，值没有拼写错误。
• 参数有效性检查：确保refresh_token未过期、格式正确；grant_type严格为"refresh_token"（大小写不能有误）。
• 获取详细错误信息：在catch块中打印服务端返回的具体错误内容，比如：

  catch (e) {
      console.log("错误详情:", e.response?.data);
      console.log(JSON.stringify(e));
  }
  

  很多时候500错误会附带服务端的具体提示，能更快定位问题。

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