You need to enable JavaScript to run this app. JS/React调用Coinbase OAuth2获取Access Token报service_unavailable
优惠活动
大模型
产品
解决方案
定价
更多

JS/React调用Coinbase OAuth2获取Access Token报service_unavailable

模糊错误的核心成因

Coinbase 的 /oauth/token 接口存在非友好的错误返回逻辑:只要请求触发了服务端解析失败、参数校验不通过,就会统一返回service_unavailable的兜底提示,搭配400状态码,不会明确告知具体的错误原因,常见触发场景包括:

  • 请求内容格式和接口要求不匹配:OAuth2 协议规范本身要求token端点使用application/x-www-form-urlencoded格式的表单传参,Coinbase未对JSON格式的请求做兼容,哪怕设置了content-type: application/json且请求体包含所有必填字段,服务端也无法正确解析参数,最终触发兜底错误
  • 请求体未做序列化处理:如果直接把普通对象作为fetch的body参数传递,浏览器会自动将其转换为无意义的[object Object]字符串,服务端无法提取任何有效参数
  • 跨阶段参数不匹配:兑换token时的redirect_uri、client_id等参数和之前获取授权码阶段的参数存在字符级差异,或是授权码被重复使用、已过期,校验流程无法正常通过
排查与修复步骤
  • 调整请求实现格式匹配
    移除手动设置的application/json请求头,使用URLSearchParams对请求参数做序列化,让fetch自动匹配接口要求的表单格式,调整后的核心请求逻辑如下:
    // 将原始参数对象传入URLSearchParams完成序列化
    const serializedBody = new URLSearchParams(data);
    fetch(url, {
      method: "POST",
      body: serializedBody
    })
    
  • 逐字段校验参数一致性
    对照OAuth应用后台的配置,以及授权码获取阶段的参数,逐字符核对兑换token请求的所有字段:
    • 确认grant_type严格为authorization_code,无多余空格、大小写错误
    • 确认redirect_uri和授权页跳转时填写的地址完全一致,不存在末尾多斜杠、参数遗漏等差异
    • 确认传入的授权码是单次使用的最新值,没有被之前的请求重复消耗
  • 抓包核验实际请求内容
    打开浏览器开发者工具的网络面板,定位该token请求,检查实际发送的请求体是否完整包含所有参数,不存在值被截断、参数丢失的问题。如果是服务端发起的请求,需要检查是否有代理层、中间件修改了请求头格式、篡改了请求体内容。

内容的提问来源于stack exchange,提问作者Scott Braaten

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 21:15:08