YouTube 字幕出现 429 错误
当 YouTube 暂时拒绝字幕请求时，字幕可能无法加载，并出现 429 错误。
这次错误来自 YouTube 字幕接口，不是沉浸式翻译服务返回的 429。最常见的情况是 YouTube 的自动翻译字幕暂时受到限制。
沉浸式翻译会先自动恢复
当 YouTube 的自动翻译字幕请求返回 429 时，沉浸式翻译会自动改为获取同一轨道的原语言字幕，再使用您选择的字幕翻译服务生成译文。
如果成功取得原语言字幕，双语字幕会继续正常显示，不需要手动切换字幕。这个过程不会继续依赖 YouTube 的自动翻译字幕。
只有自动恢复失败时，扩展才会显示错误提示。此时手动选择原语言字幕主要用于确认 YouTube 自身能否提供字幕，通常不能绕过已经失败的同一条原字幕请求。
为什么会出现 429
429 表示 YouTube 暂时拒绝了当前字幕请求。YouTube 没有公开字幕接口的具体限制规则，常见情况包括：
YouTube 自动翻译字幕受到限制
视频原语言字幕可以正常显示，但选择“自动翻译”后的语言时字幕无法加载。
这是最常见的情况。沉浸式翻译会自动去掉自动翻译目标语言，重新获取原语言字幕，通常可以避开这条更容易受到限制的请求路径。
短时间内请求了过多字幕
连续切换多种字幕语言、快速打开多个视频、反复刷新页面或不断重试，都可能在短时间内产生较多字幕请求。
遇到这种情况时，请停止连续操作，等待一段时间后再尝试。立即反复重试可能让限制持续更久。
VPN、代理或共享网络出口受到限制
YouTube 可能限制当前网络出口的字幕请求。使用 VPN、代理、公司网络、校园网络或其他共享网络时，同一个出口可能被许多用户共同使用。
如果连原语言字幕也无法显示，可以尝试：
- 切换 VPN 或代理节点；
- 暂时关闭 VPN 或代理；
- 更换网络后重新打开视频；
- 等待一段时间后再试。
当前 YouTube 会话受到限制
部分限制可能与当前 YouTube 会话、账号状态或浏览器环境有关。可以直接打开 YouTube，确认页面是否要求登录或进行安全验证，然后重新打开视频。
YouTube 字幕服务暂时异常
如果大量视频突然同时出现问题，而且更换网络、视频和字幕语言后仍无法恢复，可能是 YouTube 字幕服务或相关策略发生了临时变化。这种情况下通常只能等待 YouTube 恢复。
沉浸式翻译如何减少这类问题
在默认字幕流程中，沉浸式翻译会尽量复用 YouTube 播放器已经获取的原语言字幕，避免主动发送额外的字幕请求。
随后，沉浸式翻译使用您选择的字幕翻译服务生成译文，不需要调用 YouTube 的自动翻译字幕接口。这主要减少了两类风险：
- 重复获取同一份字幕造成的额外请求；
- 调用 YouTube 自动翻译字幕时更容易遇到的 429 限制。
如果 YouTube 的自动翻译字幕请求已经返回 429，沉浸式翻译还会自动尝试一次对应的原语言字幕请求。但如果这次请求也被限制，或没有返回有效字幕，就没有可供翻译的原文，扩展无法继续自动恢复。
仍然无法使用时
请先根据错误提示判断：
提示“YouTube 字幕请求暂时受限（429）”
这表示原语言字幕请求本身也收到了 429。此时反复切换字幕通常没有帮助，建议：
- 停止连续刷新或切换字幕，等待一段时间后重试。
- 使用 VPN 或代理时，切换节点或暂时关闭。
- 更换网络后重新打开视频。
- 直接打开 YouTube，确认是否出现登录或安全验证提示。
提示“未能自动获取视频原语言字幕”
这表示自动恢复没有取得有效的原字幕，但不一定是第二次请求也收到了 429。请在 YouTube 播放器中选择原语言字幕，确认 YouTube 自身能否正常显示：
- 如果 YouTube 也无法显示原字幕，请等待一段时间、切换网络或检查账号验证状态。
- 如果 YouTube 可以显示原字幕，请刷新页面后重试沉浸式翻译；若问题持续出现，可向我们反馈该视频链接和错误提示。
也可以按以下顺序做完整排查：
- 确认视频本身提供原语言字幕。
- 确认原语言字幕能否由 YouTube 正常显示。
- 停止连续刷新或切换字幕，等待一段时间后重试。
- 使用 VPN 或代理时，切换节点或暂时关闭。
- 更换网络，确认原语言字幕是否可以正常显示。
- 直接打开 YouTube，确认是否出现登录或安全验证提示。
如果原语言字幕始终无法在 YouTube 中显示，说明当前问题发生在沉浸式翻译开始翻译之前。请等待 YouTube 恢复后再试。