youtube-transcript-api 被 YouTube 封了？4 种可用的修复方案

现象：本地正常，生产环境被封

Python 库 youtube-transcript-api 是以编程方式获取 YouTube 字幕最常用的方案。在本地机器上，它通常运行得毫无问题。可一旦代码跑在云服务器上，请求就开始抛出 IpBlocked、RequestBlocked 或 TooManyRequests 这类异常 — 报错信息往往直接提示 YouTube 封锁了您的 IP。

所有基于爬取的方案都会遇到同一堵墙：Node.js 的字幕库、用 yt-dlp 拉取字幕、自己写的爬虫，无一例外。触发封锁的不是您的代码，而是请求的来源。

只要您的服务跑在 AWS Lambda、Google Cloud Run、Vercel、Railway、Fly.io 或任何一台 VPS 上，YouTube 看到的就是一个数据中心 IP。这些 IP 段是公开信息，长期被机器人滥用，因此被整段封锁。而家庭宽带这类住宅 IP 很少被封 — 所以"在我机器上是好的"这句话在这里是字面意义上的事实。

YouTube 为什么要封这些请求

YouTube 的字幕由一个内部的、无需鉴权的接口提供，这个接口从一开始就不是给第三方用的。获取任意视频字幕并没有官方公开 API：官方 Data API 的 captions 接口需要视频所有者进行 OAuth 授权，因此只能用于您自己的视频。

正因为这个内部接口免费且不需要鉴权，它被 AI 公司、SEO 工具和各路爬虫疯狂调用。YouTube 只能用它唯一能用的手段来应对 — 激进的限流、成片封锁数据中心 IP 段，外加时不时改动接口，让爬虫库一夜之间失效。

这意味着任何自建方案都注定陷入长期的猫鼠游戏。下面四种修复方案，按"从纯自建到纯托管"的顺序排列。

方案一：通过住宅代理转发请求

最常见的自建做法，是让请求经由轮换的住宅代理转发，这样 YouTube 看到的就是普通家庭 IP，而不是您的服务器。较新版本的 youtube-transcript-api 原生支持这一点：在构造客户端时传入代理配置即可（库里自带 WebshareProxyConfig 辅助类，也可以用 GenericProxyConfig 接入任意 HTTP/SOCKS 代理）。

这个方案确实有效，但代价不小。住宅代理的流量费很贵（通常每 GB 几美元），不同服务商的质量参差不齐，而且您还给系统引入了一类新的故障模式：某个代理 IP 在请求过程中被封时，您得自己写重试逻辑、健康检查和服务商切换。在低并发场景下，它往往还是最慢的方案，因为每个请求都要多绕一跳代理网络。

如果您需要完全的控制权、有工程人力来维护它，并且调用量大到足以摊平这套投入，那就选它。

方案二：把抓取环节放在住宅网络里跑

一个更简单的变体：把流水线中"抓字幕"这一环放在一台住宅 IP 的机器上跑 — 家里的树莓派、办公室的电脑，或者一台便宜的迷你主机 — 再通过队列或 Webhook 把结果推给云端基础设施。

这样完全省掉了代理费用，对小规模的个人用途（比如给自己做视频笔记，或者运营一份小众周刊）意外地好用。缺点也很明显：它是一个物理上的单点故障，无法扩容，而且作为生产级产品的架构显得很别扭。

方案三：做好缓存，并在报错时退避重试

无论用哪种抓取方式，有两个做法都能显著降低被封概率。第一，把抓到的每份字幕都缓存下来 — 字幕几乎不会变，同一个视频没有理由抓第二次。用一张以 video ID 为键的数据库表，就能消除绝大部分重复流量。

第二，把封锁当作信号，而不是一个可以立刻重试的错误。带抖动的指数退避（等 1 秒、2 秒、4 秒、8 秒……）能让您保持在雷达之下。被封之后立刻猛打接口，是让整个 IP 段被封的最快方式。

要注意，这只是缓解手段，不是根治方案 — 在数据中心 IP 上，哪怕是您的第一个请求也可能直接被封。请把它和其他三种方案中的一种搭配使用。

方案四：用托管的字幕 API（零基础设施维护）

托管方案：把 IP 封锁问题交给已经解决它的服务。ParseJet 只暴露一个接口 — POST /v1/parse/youtube，传入视频链接 — 就会以 JSON 返回完整字幕，外加视频标题、频道和时长。封锁、代理管理和接口变动都在服务端处理，您的代码只有三行，而且会一直是三行。

从 youtube-transcript-api 迁移过来只需要几分钟：把库调用换成一次 HTTP POST（Python、Node.js 或任何能发 HTTP 请求的环境都行 — 包括最容易被封的 Serverless 函数）。需要指定字幕语言时，传 language 参数即可。

免费额度为每月 300 积分（一个 YouTube 字幕消耗 5 积分，即 60 个视频），付费套餐每月 19 美元起。对大多数产品来说，这比住宅代理的流量费加上照看它的工程时间都要便宜。

该选哪一种？

个人项目、调用量小、又愿意折腾：方案二（住宅网络的机器）免费，可靠性也够用。

调用量大且有专职基础设施团队：方案一（轮换住宅代理）给您最大的控制权 — 但要为代理费用和持续维护留出预算。

字幕只是产品的一个功能，而不是核心业务的生产应用、智能体或 RAG 管道：选方案四（托管 API）— 一次 HTTP 调用，不必再玩猫鼠游戏。无论选哪种，都建议叠加方案三（缓存 + 退避）。