授权页面打不开或报 INVALID_CLIENT

故障一：授权页打不开 / 加载超时 / 白屏

Spotify OAuth 授权页（accounts.spotify.com 域名）在浏览器里开不出来，或加载非常慢。

排查清单

1. 浏览器能不能直接访问 Spotify：在同一个浏览器里打开 open.spotify.com，看能不能加载。如果也不行 → 网络访问 Spotify 域名整体不通
2. 代理 / 科学上网工具：检查 Spotify 域名有没有被正确分流到代理；校园网或公司网可能整体屏蔽
3. DNS 解析：换个 DNS（比如 1.1.1.1 或 8.8.8.8）试试；或直接 ping accounts.spotify.com 看能不能解析
4. 浏览器缓存：清除浏览器缓存和 Cookie 后重试；或换一个浏览器
5. 本地降级方案：在已登录 Spotify 的浏览器里手动访问授权页，授权完后把完整的回调 URL 复制粘贴到 Lyricify 里的降级输入框

故障二：INVALID_CLIENT: Invalid Redirect URI

授权页能打开，也能登录 Spotify，但点 AGREE 之后跳转回来报错 INVALID_CLIENT: Invalid Redirect URI。

排查清单（按概率从高到低）

1. 自定义 API Client 里的 Redirect URI 格式错误

• 打开 Spotify Developer Dashboard → 找到你的应用 → Edit Settings → 看 Redirect URI 列表
• 有没有 http://127.0.0.1:766/callback（注意是 http、127.0.0.1、没有 www、端口 766）
• 有没有多余的 https:// 版本或 localhost 版本（必须删掉）
• 两条 URI（http://127.0.0.1:766/callback 和 lyricify://callback）是不是都添加了
• 注意 Redirect URI 是精确匹配——大小写、末尾斜杠、协议头有一点不一样就无效

1. 旧版本 Lyricify 的坑

• 低于 4.3.48 的 Lyricify 版本使用了旧的 Redirect URI 格式（localhost:766/callback），2025 年后 Spotify 不再接受
• 解决：更新 Lyricify 到最新版本，覆盖安装即可（配置和歌词库不会丢）

1. 自定义 Client 和公共 Client 混了

• 如果你在配置自定义 Client 后又登出重新授权，但 Lyricify 又走了公共 Client 的默认流程，可能会拿错 Client ID
• 解决：彻底登出 → 删除设置文件里的 customApiClient 条目 → 重新配置自定义 Client → 再授权一次

故障三：授权完没回到 Lyricify

授权完浏览器显示 "成功！Spotify 授权成功"，但 Lyricify 窗口里没反应。

• 原因：Lyricify 没在监听本地 766 端口，或被防火墙拦了
• 解决：关闭浏览器标签页前等 3 秒；还是不行就用降级方案（复制回调 URL 手动粘贴）