使用Pytube开发YouTube下载器时遭遇'streamingData' KeyError问题求助

常见原因与解决方案 #

1. 安装Pytube的最新修复版本 #

YouTube的视频解析规则频繁更新，官方12.1.3版本可能存在未修复的解析bug。直接安装GitHub上的最新代码：

pip uninstall pytube -y
pip install git+https://github.com/pytube/pytube.git

2. 处理视频权限/地区限制 #

如果目标视频存在年龄限制、地区封锁或需要登录才能观看，Pytube无法直接获取streamingData：

• 先测试无限制的公开视频，确认代码逻辑正常
• 若需下载受限视频，添加Cookie支持：
  从浏览器导出Netscape格式的cookie文件，然后在代码中加载：

  from pytube import YouTube
  from pytube.cookies import CookieJar
  
  def start_download():
      try:
          yt_link = link.get()
          cj = CookieJar()
          cj.load('cookies.txt', ignore_discard=True, ignore_expires=True)
          yt_object = YouTube(yt_link, cookies=cj, on_progress_callback=on_progress)
          # 后续代码不变
      except Exception as e:
          finish_label.configure(text=f"An error occurred: {e}", text_color="red")
  

3. 排查网络环境问题 #

IP被YouTube屏蔽或网络需要代理时，也会导致解析失败：

• 切换网络环境（如手机热点）测试
• 给Pytube设置代理：

  yt_object = YouTube(
      yt_link,
      proxies={"http": "http://your-proxy-address:port", "https": "https://your-proxy-address:port"},
      on_progress_callback=on_progress
  )
  

4. 调整代码触发完整解析 #

在获取流之前，先触发Pytube的视频信息解析流程，避免解析不完整：

def start_download():
    try:
        yt_link = link.get()
        yt_object = YouTube(yt_link, on_progress_callback=on_progress)
        yt_object.title  # 强制触发视频信息解析
        video = yt_object.streams.get_highest_resolution()
        # 后续代码不变
    except Exception as e:
        finish_label.configure(text=f"An error occurred: {e}", text_color="red")

内容的提问来源于stack exchange，提问作者Robert