Spotipy授权码流遇“Only valid bearer authentication”错误求助

以下是针对你遇到的问题的排查方向和解决方案：

1. 排查Token获取逻辑是否正确 #

Authorization Code Flow生成的是用户级token，和Client Credentials Flow的应用级token完全不同，混用会直接触发这个错误。

• 确保使用SpotifyOAuth而非SpotifyClientCredentials来初始化认证管理器：

  import spotipy
  from spotipy.oauth2 import SpotifyOAuth
  import os
  
  # 正确的Authorization Code Flow初始化方式
  auth_manager = SpotifyOAuth(
      client_id=os.getenv("SPOTIPY_CLIENT_ID"),
      client_secret=os.getenv("SPOTIPY_CLIENT_SECRET"),
      redirect_uri=os.getenv("SPOTIPY_REDIRECT_URI"),
      scope="user-read-currently-playing user-read-private"  # 按需添加权限
  )
  sp = spotipy.Spotify(auth_manager=auth_manager)
  

• 检查缓存的token内容：打印auth_manager.get_cached_token()，确认返回的字典包含access_token和refresh_token字段——如果只有access_token，说明你可能误用了Client Credentials Flow的逻辑。

2. 确认权限范围（Scope）生效 #

修改scope后必须重新授权，旧缓存的token不会自动更新权限：

• 确保scope包含你要调用的API所需权限：
  • 获取当前播放歌曲：user-read-currently-playing
  • 获取用户基本信息：user-read-private
• 完全清除缓存文件（默认是.cache或.cache-<用户名>），重新运行程序并完成登录授权，新token才会包含新的scope。

3. 避免手动干预认证头 #

Spotipy的auth_manager会自动处理Authorization头，不要手动添加：

• 不要在代码中写类似sp._auth = "Bearer xxx"的语句，这会覆盖auth_manager的自动处理逻辑。
• 如果手动管理token生命周期，确保正确传入有效token：

  token_info = auth_manager.get_cached_token()
  if not token_info or auth_manager.is_token_expired(token_info):
      token_info = auth_manager.refresh_access_token(token_info["refresh_token"])
  sp = spotipy.Spotify(auth=token_info["access_token"])
  

4. 验证环境变量与后台配置一致性 #

• 打印环境变量确认值正确：print(os.getenv("SPOTIPY_CLIENT_ID"))，避免出现空值或拼写错误。
• 确认Spotify开发者后台配置的Redirect URI和代码中完全一致：包括协议（http/https）、端口、路径，比如后台是http://localhost:8080/callback，代码里就不能写成http://localhost:8080。

快速测试方法 #

用获取到的access_token直接调用API，排查是token问题还是Spotipy使用问题：

# 替换成你的access_token
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.spotify.com/v1/me/player/currently-playing

• 如果curl返回正常，说明Spotipy的初始化或token传递有问题；
• 如果curl同样报错，说明token本身无效，重新授权生成新token。

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