切歌后歌词反应迟钝、还是上一首歌

故障现象

切歌后：

• 歌词区域还显示上一首歌的歌词，几秒后才跳过来
• 或歌名和艺人已经换成新的了，但歌词区域迟迟不更新
• 偶尔歌词直接卡死在某一行

排查清单

一、检查 429 状态（最常见根因）

Lyricify 右下角或设置里有没有 "429" 提示，或主菜单里有没有 API 限流的警告。有就是 Spotify Web API 请求被限了，歌词信息拉取不回来。

解决：

• 没配自定义 Client → 调高同步频率（4 或 6 秒）、关掉没放歌时的 Lyricify
• 已经是 Premium → 尽快配自定义 API Client，拿到独立配额

二、Premium 用户检查智能引擎

Premium 订阅下，Lyricify 智能引擎（Lyricify Intelligent Engine）负责更精准的歌词切换和预加载。设置 → 功能里看看有没有开。没开的话切歌歌词不会做预加载，反应自然慢。

三、Media Session vs Web API 哪个在主导

如果 Media Session 连接正常（右上角有图标），Lyricify 会优先用本地 Media Session 来获取切歌信息——这条通道零延迟，切歌反应应该很快。

如果 Media Session 没连接 → 只能走 Spotify Web API → 有网络延迟 → 切歌反应慢。

检查 Media Session 状态 → 连不上的话参考 Media Session 连接与故障排查。

四、免费账号的典型情况

免费账号没有 Premium 的智能引擎，也不支持某些 Web API 的快速切换。但只要 Media Session 正常连接，切歌反应理论上和 Premium 差不多——因为 Media Session 是本地接口，和账号类型无关。

免费账号切歌迟钝最常见的原因就是 Media Session 没连上。 按优先级检查：

1. Spotify 桌面客户端有没有在运行
2. 放一首歌，等 Media Session 图标出来再切
3. 不行就重启 Spotify + Lyricify

五、换播放器或用 Web Player

• Spotify Web Player 的 Media Session 可能不如桌面客户端稳定
• 如果你同时开了多个 Spotify 实例（桌面 + 手机 + 网页），切歌信息可能来自不同设备，Lyricify 容易混乱 → 建议同时只在一台设备上放歌