Spotify API 时而正常，调用sp.album时无限停滞求助

API 探路者

2026-8-8

Spotipy API调用接口无限停滞的解决方法

检查网络代理与防火墙设置：这类请求停滞常由网络拦截导致，Spotify API域名可能被代理或防火墙限制。尝试关闭代理直接访问，或在防火墙规则中允许Spotipy相关请求出站。
给Spotipy客户端添加超时配置：Spotipy默认无超时设置，会导致请求无限挂起。初始化客户端时指定超时参数，强制超时后抛出异常：
```
sp = spotipy.Spotify(auth_manager=auth_manager, requests_timeout=10)
```

切换认证方式测试：若当前用授权码流，换成客户端凭证流排查授权问题：

from spotipy.oauth2 import SpotifyClientCredentials
auth_manager = SpotifyClientCredentials(client_id="你的客户端ID", client_secret="你的客户端密钥")
sp = spotipy.Spotify(auth_manager=auth_manager)

排查API限流情况：部分接口触发Spotify限流时可能无错误返回而是挂起，前往Spotify开发者后台查看API调用统计，确认是否存在异常限流。
更新Spotipy至最新版本：旧版本可能存在请求处理bug，执行命令更新：
```
pip install --upgrade spotipy
```
用curl手动测试API端点：绕过Spotipy客户端直接调用API，判断问题出在网络还是代码：
```
curl -H "Authorization: Bearer 你的访问令牌" https://api.spotify.com/v1/albums/目标专辑ID
```
如果curl也停滞，优先排查网络问题；若curl正常返回，再检查Spotipy客户端的配置细节。