Spotify API调用出现403(Forbidden)错误的排查求助

开发者阿泽

2026-7-3

排查Spotify API 403 Forbidden错误方案

1. 确认权限范围（Scope）是否合规

调用/me/top/artists接口必须申请user-top-read权限，你需要检查授权流程中是否包含该scope。如果授权时未添加，哪怕access_token未过期，也会返回403。可以解码token的JWT内容，查看其中的scope列表，确认是否存在user-top-read。

2. 检查请求头格式

确保请求头的Authorization字段严格遵循Bearer {access_token}格式，注意Bearer和token之间必须有一个空格，格式错误是403的常见诱因。示例正确写法：

headers: {
  'Authorization': `Bearer ${你的access_token}`
}

3. 排查Async函数的逻辑问题

Async关键字本身不会直接导致403，但异步逻辑错误可能间接引发问题，需检查：

是否在async函数内正确使用await处理请求，避免token未注入请求头就发送请求
异步流程中是否存在token被意外修改、覆盖的情况
参考标准async请求写法：

async function fetchTopArtists() {
  const accessToken = '你的有效token';
  try {
    const res = await fetch('https://api.spotify.com/v1/me/top/artists', {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${accessToken}`
      }
    });
    if (!res.ok) {
      const errDetail = await res.json();
      console.error('API错误详情:', errDetail);
      return;
    }
    const data = await res.json();
    console.log(data);
  } catch (err) {
    console.error('请求异常:', err);
  }
}