Lyricify 中文文档 下载 App

公共 Client 与超长 429 的对策

什么是公共 Client

配置自定义 API Client 时,Lyricify 会让你在等待授权的过程中选择「是」使用自定义 Client,还是「否」——「否」代表继续使用 Lyricify 默认的公共 API Client。

这个公共 Client 是 Lyricify 开发者在 Spotify Developer Dashboard 里创建的一个共享 Client ID / Secret,所有没有自定义 Client 的用户共用。配额被所有用户一起消耗,是 429 限流和超长 429 的主要来源。

对策一:配置自定义 Client(最有效)

见 上一页。拿到独立配额后,429 基本消失。但 Premium 订阅是硬要求。

对策二:公共 Client + 手动重建

如果你是 Premium 订阅但暂时不想花时间配自定义 Client,或者已经配了但连续使用触发了超长 429:

  1. 关掉 Lyricify
  2. 等超长 429 倒计时结束
  3. 重新启动 Lyricify,它会自动切换回你的自定义 Client(公共 Client 只在超长 429 期间作为降级替代)
  4. 如果自定义 Client 本身也超长,去 Spotify Developer Dashboard 再新建一个 Client,重新配置

对策三:多设备分散配额

如果你有很多台设备都在跑 Lyricify(Windows + 安卓 + iPhone),每台设备创建一个独立的自定义 API Client。

这样每台设备都有自己独立的配额,不会因为其中一台连续使用而把所有设备一起拖下水。Spotify Developer Dashboard 里创建多个 Client 没有数量限制(至少在合理范围内)。

降低超长 429 出现概率的日常习惯

开发者的建议,优先级从高到低:

  1. 连续使用时间控制在 10 小时以内。连续十几个小时运行会大幅提高触发概率。
  2. 没有播放内容时关掉 Lyricify。没有音乐在放时 Lyricify 仍然按同步频率请求 API,几小时就能触发。
  3. 多台设备同时用 → 每台设备独立 Client。分散请求。
  4. 同步频率调低一点。默认 2 秒没问题,如果已经配了自定义 Client 可以调回去;如果用公共 Client 就调高一点。
  5. 多账号场景:如果你有多个 Spotify 账号(比如家里人用不同账号),每个账号配自己的自定义 Client,进一步隔离。

免费账号的处境

免费账号无法使用自定义 API Client,也无法选择公共 Client 替代——免费账号只能用公共 Client,也没有 Premium 订阅来解锁自定义 Client 的入口。

免费账号要避免 429: