Spotify API返回429错误时响应头缺失Retry-After字段求助

问题背景 #

调用Spotify的/v1/audio-features/{track_id}端点时触发429限流错误，但响应头中未返回文档承诺的Retry-After字段，无法直接获取重试等待时间。

相关代码：

url = f'https://api.spotify.com/v1/audio-features/{track_id}'
res = requests.get(url, headers=self.headers)
if res.ok:
    return res.json()
if res.status_code == 429:
    print("------------- 429 ----------------")
    print(res.headers)
    return None

收到的响应头：

{
   "content-type": "application/json; charset=utf-8",
   "cache-control": "private, max-age=0",
   "access-control-allow-origin": "*",
   "access-control-allow-headers": "Accept, App-Platform, Authorization, Content-Type, Origin, Retry-After, Spotify-App-Version, X-Cloud-Trace-Context, client-token, content-access-token",
   "access-control-allow-methods": "GET, POST, OPTIONS, PUT, DELETE, PATCH",
   "access-control-allow-credentials": "true",
   "access-control-max-age": "604800",
   "content-encoding": "gzip",
   "strict-transport-security": "max-age=31536000",
   "x-content-type-options": "nosniff",
   "date": "Mon, 22 Jul 2024 11:51:11 GMT",
   "server": "envoy",
   "Via": "HTTP/2 edgeproxy, 1.1 google",
   "Alt-Svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
   "Transfer-Encoding": "chunked"
}

可能原因 #

• 中间代理/CDN修改响应头：从响应头的Via字段可见请求经过了edgeproxy和Google代理，部分代理会过滤或移除Retry-After这类响应头。
• Spotify API限流策略差异：部分端点或临时高频限流场景下，Spotify可能不返回Retry-After头，仅在全局额度耗尽时才返回。
• 未检查响应体：Spotify的429响应可能在JSON body中包含retry_after字段，而非响应头里，当前代码未读取响应体内容。

解决方案 #

1. 优先检查响应体内容 #

修改代码，打印429响应的JSON内容，确认是否包含重试提示：

if res.status_code == 429:
    print("------------- 429 ----------------")
    print(res.headers)
    # 新增：打印响应体，查看是否有重试提示
    try:
        print(res.json())
    except:
        print(res.text)
    return None

多数情况下，Spotify会在响应体的error.retry_after字段返回等待秒数。

2. 实现指数退避重试（不依赖Retry-After） #

不管是否有Retry-After头，指数退避都是更鲁棒的限流处理方案。可以用tenacity库实现：

from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_result

def is_429(response):
    return response.status_code == 429

@retry(
    stop=stop_after_attempt(5),  # 最多重试5次
    wait=wait_exponential(multiplier=1, min=2, max=30),  # 等待时间：2s→4s→8s…最大30s
    retry=retry_if_result(is_429)
)
def get_audio_features(track_id, headers):
    url = f'https://api.spotify.com/v1/audio-features/{track_id}'
    res = requests.get(url, headers=headers)
    if res.status_code == 429:
        # 如果响应体有retry_after，用它覆盖等待时间
        try:
            retry_after = res.json().get("error", {}).get("retry_after")
            if retry_after:
                raise retry.TryAgain(retry=retry_after)
        except:
            pass
    res.raise_for_status()  # 非200状态码触发重试
    return res.json()

3. 验证认证与限流额度 #

• 确保使用OAuth 2.0令牌请求：认证后的请求限流额度更高，且更易返回标准Retry-After头。
• 查看Spotify开发者后台的API调用统计，确认是否触及全局限流额度，而非临时高频请求。

4. 绕过中间代理（如果可行） #

如果请求经过公司或本地代理，尝试直接请求Spotify API，检查是否能获取到Retry-After头。

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