使用Spotipy模块调用Spotify API时Jupyter Python3 Kernel冻结求助

针对你遇到的Kernel无报错冻结、时好时坏的问题，从代码和环境层面给出具体排查与解决方向：

1. 给Spotify请求添加超时限制 #

Spotipy默认未设置请求超时，一旦Spotify服务器响应缓慢或网络异常，请求会无限阻塞导致Kernel冻结。初始化客户端时明确添加超时参数：

import spotipy
from spotipy.oauth2 import SpotifyClientCredentials

# 设置10秒超时，可根据网络情况调整
sp = spotipy.Spotify(
    auth_manager=SpotifyClientCredentials(),
    requests_timeout=10
)

2. 优化请求会话管理，避免连接泄漏 #

频繁请求可能耗尽连接池，导致后续请求因无法获取连接而挂起。手动管理请求会话并添加重试机制：

import requests
from spotipy.client import Spotify
from spotipy.oauth2 import SpotifyClientCredentials

# 创建带重试策略的会话
session = requests.Session()
adapter = requests.adapters.HTTPAdapter(max_retries=3)
session.mount('https://', adapter)

sp = Spotify(
    auth_manager=SpotifyClientCredentials(),
    requests_session=session,
    requests_timeout=10
)

# 批量请求完成后可手动关闭会话释放资源
# session.close()

3. 排查WSL/Docker网络异常 #

跨WSL和Docker的网络层可能存在连接释放不彻底的问题：

• 运行Docker容器时添加--network host参数，跳过容器网络NAT层，减少网络不稳定因素
• 执行wsl --shutdown重启WSL服务，重置网络状态
• 检查WSL防火墙设置，确保未拦截Spotify API的HTTPS请求（端口443）

4. 监控容器资源占用 #

Kernel冻结时，用docker stats命令查看容器的CPU、内存使用情况，确认是否因资源耗尽导致无响应。若内存不足，运行容器时可分配更多内存：

docker run --memory=4g ...  # 给容器分配4GB内存

5. 更新依赖版本 #

旧版本的Spotipy或requests可能存在死锁、连接bug，更新到最新版本：

conda update spotipy requests pandas

6. 添加日志与异常捕获 #

给API调用添加日志和异常捕获，即使超时也会抛出异常而非冻结，方便定位问题：

import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

try:
    logger.info("发起Spotify API请求")
    response = sp.search(q="test", type="track")
    logger.info("请求完成")
except Exception as e:
    logger.error(f"请求失败: {str(e)}")

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