Node.js调用Spotify API遇unsupported_grant_type错误求助

我完全懂你现在的郁闷——明明已经把grant_type指定成了authorization_code，结果还是收到了提示说grant_type只能是client_credentials、authorization_code或refresh_token的错误，这种“参数看起来没问题但就是报错”的情况真的很磨人。咱们一步步拆解可能的问题点：

1. 先确认Authorization头的Base64编码是否正确 #

你的代码片段里Buffer.from(${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}).toString('...')这里的'...'应该是'base64'吧？如果这里写错了（比如漏写或者用了其他编码格式），Spotify会无法正确识别你的客户端身份，进而可能导致对grant_type的验证逻辑出错。正确的写法应该是：

const auth = Buffer.from(`${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}`).toString('base64');

同时别忘了在请求头里加上完整的Authorization字段：

headers: {
  'Authorization': `Basic ${auth}`,
  'Content-Type': 'application/x-www-form-urlencoded'
}

2. 重点检查POST请求的参数格式——必须是x-www-form-urlencoded #

这绝对是Spotify Token端点的硬性要求！很多开发者会踩这个坑：把参数用JSON格式发送，但Spotify的授权服务器根本不接受这种方式。你需要把grant_type=authorization_code、code、redirect_uri这些参数编码成标准的表单格式，而不是放在JSON请求体里。

举个用fetch实现的正确示例：

fetch('https://accounts.spotify.com/api/token', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'authorization_code',
    code: req.body.code, // 用户授权后拿到的授权码
    redirect_uri: 'https://your-app.com/callback' // 必须和授权请求时的地址完全一致
  })
})

如果用Express框架，还要确保你的路由能正确解析表单数据——可以在这个路由上单独挂载express.urlencoded({ extended: true })中间件，避免被express.json()这类中间件干扰。

3. 核对参数的拼写和完整性 #

• 确认grant_type的拼写完全正确：是authorization_code（全小写、下划线分隔，没有任何拼写错误）
• 必须同时传递code（用户完成授权后返回的授权码）和redirect_uri（这个地址必须和你发起授权请求时用的redirect_uri完全一致，包括协议、域名、路径，哪怕多一个斜杠都不行）
• 检查环境变量CLIENT_ID和CLIENT_SECRET是否正确加载，有没有为空或者包含多余的空格、换行符

4. 排查请求是否被中间件意外修改 #

如果你在Express里用了express.json()全局中间件，它会自动把所有POST请求的体解析成JSON格式，这会导致你的表单参数无法被Spotify正确识别。解决办法要么是把这个路由排除在express.json()的作用范围外，要么在这个路由上优先使用express.urlencoded()中间件。

给你一个完整的Express路由示例参考：

app.post('/auth', express.urlencoded({ extended: true }), (req, res) => {
  const auth = Buffer.from(`${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}`).toString('base64');
  
  fetch('https://accounts.spotify.com/api/token', {
    method: 'POST',
    headers: {
      'Authorization': `Basic ${auth}`,
      'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: new URLSearchParams({
      grant_type: 'authorization_code',
      code: req.body.code,
      redirect_uri: 'https://your-app.com/callback' // 替换成你的实际回调地址
    })
  })
  .then(response => response.json())
  .then(data => res.json(data))
  .catch(err => res.status(500).json({ error: err.message }));
});

先从这几个方向排查，尤其是Content-Type和参数格式的问题，这是触发这个错误最常见的原因。

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