无图形界面Linux设备上如何通过spotipy完成Spotify OAuth授权

现有实现的运行局限 #

当前使用的 util.prompt_for_user_token 授权逻辑，在带图形界面的Windows环境下可正常自动唤起本地浏览器完成授权交互，但在无显示输出的headless Linux设备上，因缺少本地图形浏览器运行环境，无法自动触发授权页跳转，导致无法获取有效授权码，流程中断。

核心适配思路 #

完全绕开代码自动唤起本地浏览器的逻辑，利用跨设备手动交互的方式完成授权流程，无需在headless Linux设备上部署任何额外的图形依赖、临时web拦截服务。

具体实现步骤 #

• 初始化Spotify授权管理器时，直接关闭自动唤起浏览器的开关。
• 终端打印生成好的Spotify授权链接，用户可在任意带图形界面的设备（个人电脑、手机）上打开链接，完成账号授权确认。
• 授权完成后，Spotify会将携带授权码的请求重定向到预先配置的http://localhost:4466地址，此时只需从浏览器地址栏复制完整的重定向URL，粘贴回headless Linux的终端交互窗口即可。
• 授权管理器自动解析URL中的授权码，换取可用的访问令牌，完成全流程认证。

可直接复用的实现代码 #

import spotipy
from spotipy.oauth2 import SpotifyOAuth

# 初始化授权管理器，禁用自动唤起浏览器
auth_manager = SpotifyOAuth(
    client_id="<clientID>",
    client_secret="<client_secret>",
    redirect_uri="http://localhost:4466",
    scope="user-read-currently-playing",
    open_browser=False
)

# 终端输出需手动访问的授权链接
auth_url = auth_manager.get_authorize_url()
print(f"请在任意带图形界面的设备打开以下链接完成Spotify授权：\n{auth_url}")

# 接收用户粘贴的重定向地址，解析授权码并完成令牌交换
callback_url = input("\n授权完成后，请将浏览器跳转后的完整URL粘贴到此处：")
code = auth_manager.parse_response_code(callback_url)
auth_manager.get_access_token(code, check_cache=False)

# 生成可正常调用接口的Spotify实例
spotify = spotipy.Spotify(auth_manager=auth_manager)

长期运行优化提示 #

• 首次授权成功后，授权管理器会自动将令牌信息缓存到本地文件，后续运行时只要缓存未失效，将自动完成令牌刷新，无需重复手动交互。
• 部署时需确保缓存文件的读写权限正常，避免令牌丢失导致重新授权。
• 无需在headless Linux设备上临时启动4466端口的web服务接收重定向请求，纯手动复制回调URL的流程稳定性更高，无额外网络配置成本。

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