Spotify API addTracks接口POST请求被识别为GET导致401错误求助

嘿，这个问题我之前在做Spotify相关项目时也踩过坑，咱们来一步步捋清楚问题所在：

首先解决请求被识别为GET的问题 #

浏览器把本该是POST的请求转成GET，大概率是这几个原因：

• 如果是用HTML表单提交的：默认method是GET，一定要明确加上<form method="POST">，不然浏览器会自动用GET请求，这完全不符合Spotify接口的要求。
• 如果是用JS（fetch/axios）发起请求：检查代码里有没有写对method: 'POST'，比如axios里是method: 'post'，fetch里是method: 'POST'，别漏写或者写错成GET了。
• 有没有误触发了跳转/锚点？比如按钮的默认行为没阻止，导致页面跳转，把POST请求变成了GET导航。

这个问题必须先解决，因为Spotify的/playlists/{id}/tracks接口只接受POST请求，用GET的话不仅会返回错误，还会导致认证逻辑不匹配，进一步触发401。

然后排查401认证错误的核心原因 #

你说认证配置没问题，但还是要检查这几个关键细节：

1. 令牌的权限范围（Scope）
   Spotify的添加曲目接口需要playlist-modify-public（修改公开播放列表）或者playlist-modify-private（修改私有播放列表）权限。你在授权用户的时候，有没有在请求里包含这些scope？如果授权时没加，哪怕令牌有效，也会因为权限不足返回401（有时候是403，但不同场景下可能返回401）。
   比如授权URL应该类似：

   https://accounts.spotify.com/authorize?client_id=YOUR_CLIENT_ID&response_type=code&redirect_uri=YOUR_REDIRECT_URI&scope=playlist-modify-public%20playlist-modify-private
   

2. Authorization头的格式
   确保请求头里的Authorization字段是Bearer {你的access_token}，注意Bearer后面有一个空格，别漏了！很多人在这里写错，导致令牌不被识别。
3. 令牌是否过期
   Spotify的access token有效期只有1小时，你有没有实现刷新令牌的逻辑？如果令牌过期了，也会返回401。可以把当前的access token复制到Spotify官方调试工具里验证有效性。
4. 请求头的Content-Type
   提交JSON数据时，必须设置Content-Type: application/json，不然Spotify的服务器可能无法解析请求体，也会导致认证或者请求失败。

正确的addTracks请求示例 #

给你一个用fetch实现的正确调用示例，你可以对比自己的代码看看哪里不一样：

async function addTracksToPlaylist(playlistId, trackUris, accessToken) {
  const apiUrl = `https://api.spotify.com/v1/playlists/${playlistId}/tracks`;
  
  try {
    const response = await fetch(apiUrl, {
      method: 'POST', // 必须是POST
      headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        uris: trackUris // 注意是uris，不是tracks，格式是["spotify:track:xxxxxx"]
      })
    });

    if (!response.ok) {
      const errorDetails = await response.json();
      console.log('Spotify API Error:', errorDetails);
      throw new Error(`请求失败，状态码：${response.status}`);
    }

    const result = await response.json();
    console.log('曲目添加成功:', result);
    return result;
  } catch (err) {
    console.error('添加曲目出错:', err);
  }
}

排查步骤总结 #

1. 打开浏览器开发者工具的Network标签，找到addTracks的请求，确认Method列是POST，如果不是，先修正请求发起方式。
2. 检查授权时的scope是否包含playlist-modify-public或playlist-modify-private，如果没有，重新授权用户。
3. 验证Authorization头的格式是否正确，令牌是否有效且未过期。
4. 确保请求头包含Content-Type: application/json，请求体是正确的JSON格式。

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