Spotify OAuth授权报invalid_request需提供code 未跳转及Colab调试问题

授权模式逻辑混用 #

你当前代码同时使用了两套互不兼容的Spotify授权流程：

• SpotifyClientCredentials 属于客户端凭证模式，仅用于访问无需用户权限的公共接口，无法支持user-library-read这类需要用户授权的scope，和你调用的prompt_for_user_token（授权码模式）逻辑完全冲突
• prompt_for_user_token 是授权码模式的内置方法，要求运行环境支持本地端口回调，不能提前初始化客户端凭证模式的授权对象

Colab环境与原生回调逻辑不兼容 #

prompt_for_user_token 默认会在运行环境的127.0.0.1本地端口启动临时监听服务，等待Spotify授权后的回调跳转。在Google Colab这类远程容器环境运行时：

• 本地127.0.0.1是Colab的隔离容器，并非你本机，Spotify的回调请求无法穿透到该监听服务
• 你配置的重定向URI是https://www.google.com/，授权完成后Spotify会直接重定向到Google首页，不会将授权码回调到Colab的临时端口，若手动复制回调URL时漏带URL中的?code=xxx参数，就会直接触发code must be supplied报错

重定向URI配置校验 #

你需要确认Spotify开发者后台的Redirect URIs配置和代码中的redirect_uri完全精确匹配，覆盖以下所有细节：

• 协议头（http/https）
• 域名大小写
• 路径
• 末尾斜杠
  你当前使用https://www.google.com/作为重定向URI本身是合规的，Spotify不会校验该域名的所有权，只要代码和后台配置完全一致即可正常使用。

清理冗余代码 #

删除冲突的SpotifyClientCredentials初始化代码，授权码模式无需提前创建该对象。

改用手动授权流程适配远程环境 #

放弃原生prompt_for_user_token的自动监听回调逻辑，拆分为手动步骤完成授权：

1. 生成授权链接，手动在浏览器打开完成登录授权
2. 从授权后跳转的Google页面地址栏，完整复制带code参数的URL
3. 将URL粘贴到Colab的输入框中，由代码解析出授权码并换取访问token

可直接运行的修复后代码 #

import sys
import spotipy
from spotipy.oauth2 import SpotifyOAuth

client_id = '你的client_id'
client_secret = '你的client_secret'
redirect_uri = 'https://www.google.com/'
scope = 'user-library-read'

# 配置适配远程环境的OAuth参数，禁用自动回调逻辑
sp_oauth = SpotifyOAuth(
    client_id=client_id,
    client_secret=client_secret,
    redirect_uri=redirect_uri,
    scope=scope,
    open_browser=False, # 禁用无意义的自动开浏览器逻辑
    cache_path=None # 禁用本地token缓存，避免Colab读写权限问题
)

# 生成并打印授权链接
auth_url = sp_oauth.get_authorize_url()
print(f"请手动打开以下链接完成授权：\n{auth_url}")

# 接收用户粘贴的完整跳转URL
redirected_url = input("请粘贴授权完成后跳转的完整URL（需包含code参数）：")

# 解析授权码并获取有效访问token
code = sp_oauth.parse_response_code(redirected_url)
token_info = sp_oauth.get_access_token(code, check_cache=False)

# 初始化Spotify客户端
sp = spotipy.Spotify(auth=token_info['access_token'])

• 粘贴跳转URL时必须完整复制，不能截断?code=后的参数，否则会触发code must be supplied报错
• 不要将真实的client_id、client_secret硬编码在公开的Colab Notebook中，建议使用Colab的用户密钥存储功能保存敏感信息
• 确认测试用的Spotify账号已添加到开发者后台的用户管理列表中，否则即使授权流程正常也会返回权限错误

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