Node.js 使用OAuth对接第三方授权服务无法获取access token求助

首先先完善错误日志，定位具体错误原因：
你当前的错误捕获逻辑只打印了通用提示，没有输出第三方服务返回的具体错误信息，先修改getTokens方法的catch块，拿到完整的错误响应：

catch (error: any) {
  // 打印第三方返回的完整错误信息，OAuth标准错误会包含error、error_description字段
  console.error(`Failed to fetch auth tokens, detail:`, error.response?.data || error.message)
  throw new Error(error.message)
}

拿到具体错误码后，可对照以下常见问题排查：

• redirect_uri 不匹配：这是OAuth对接最常见的错误
  你当前传入的redirectUri值为localhost:2000/${redirectURI}，缺少http://或https://协议前缀，OAuth规范要求换token时传入的redirect_uri必须和三个位置的取值完全一致：1. 第三方开发者后台注册的回调地址 2. 前端发起授权跳转请求时携带的redirect_uri参数，协议、域名、端口、路径、末尾斜杠都不能有差异。
• 授权码code无效：
  授权码为一次性凭证，有效期通常只有5~15分钟，使用过一次就会立即作废，不要刷新回调页面重复使用同一个code。同时先打印req.query.code确认拿到的code没有被转义、截断。
• 参数传递方式不符合要求：
  部分OAuth服务要求client_id和client_secret不能放在请求body中，需要放到请求头中通过Basic auth传递，格式为Authorization: Basic base64(client_id:client_secret)，可查阅对接服务的官方文档确认参数传递要求。
  另外确认服务是否支持application/x-www-form-urlencoded格式的请求，部分服务要求请求体为JSON格式。
• 凭证值错误：
  确认CLIENT_ID、CLIENT_SECRET的取值是否正确，有没有多空格、大小写错误，环境变量是否正常读取。

修复后的参考代码 #

getTokens方法调整（可选添加Basic auth支持） #

export async function getTokens({
  code,
  clientId,
  clientSecret,
  redirectUri,
}: {
  code: string
  clientId: string
  clientSecret: string
  redirectUri: string
}) {
  const url = "https://api.specificservice.dev/oauth/v1/token"
  const values = {
    code,
    client_id: clientId,
    client_secret: clientSecret,
    redirect_uri: redirectUri,
    grant_type: "authorization_code",
  }
  // 如果需要Basic auth就打开以下注释，删除body里的client_id、client_secret
  // const authHeader = `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString('base64')}`
  try {
    const res = await axios.post(url, new URLSearchParams(values), {
      headers: {
        "Content-Type": "application/x-www-form-urlencoded",
        // Authorization: authHeader
      },
    })
    console.log(res.data)
    return res.data
  } catch (error: any) {
    console.error(`Failed to fetch auth tokens, detail:`, error.response?.data || error.message)
    throw new Error(error.message)
  }
}

回调路由调整 #

app.get(`/${redirectURI}`, async (req, res) => {
  try {
    const code = req.query.code as string
    if (!code) {
      return res.status(400).send('Missing authorization code')
    }
    const { access_token } = await getTokens({
      code,
      clientId: CLIENT_ID,
      clientSecret: CLIENT_SECRET,
      // 补全协议前缀，确保和注册的、授权请求时的地址完全一致
      redirectUri: `http://localhost:2000/${redirectURI}`,
    })
    const userInfo = await axios.get(
      `https://authurlfromspecificservice`,
      { headers: { Authorization: `Bearer ${access_token}` } }
    )
    console.log('User info:', userInfo.data)
    // 必须给客户端返回响应，或者跳转到前端页面
    res.send('Login success')
  } catch (err) {
    console.error('Callback error:', err)
    res.status(500).send('Login failed')
  }
})

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