使用Pytube下载YouTube视频时提示无效视频的问题求助

问题描述 #

使用Pytube库下载YouTube视频时，程序始终提示视频无效，使用的代码如下：

import customtkinter
import tkinter
from pytube import YouTube


def startdownload():
    try:
        ytLink = Link.get()
        ytObject = YouTube(ytLink)
        video = ytObject.streams.get_highest_resolution()  # change this line
        video.download()
    except:
        print("YouTube link is invalid")
    print("youtube Link complete")



# Adding UI Elements
title = customtkinter.CTkLabel(app, text="Insert a youtube link")
title.pack(padx=10, pady=10)

# Link Input
url_var = tkinter.StringVar()
Link = customtkinter.CTkEntry(app, width=350, height=40, textvariable=url_var)
Link.pack()

# Download Button
download = customtkinter.CTkButton(app, text="Download", command=startdownload)
download.pack(padx=10, pady=10)

问题分析 #

• 异常捕获过于宽泛：原代码用except:捕获所有异常，无论实际错误是链接格式问题、UI未初始化、网络故障还是Pytube解析失败，都会统一输出“YouTube link is invalid”，无法定位真实问题。
• 缺少应用实例初始化：代码直接使用app变量，但未创建customtkinter.CTk()实例，运行时会先抛出NameError，被宽泛的异常捕获后误判为链接无效。
• Pytube版本兼容问题：YouTube页面结构会不定期更新，旧版本Pytube可能无法正常解析视频链接，导致解析失败。
• 网络/地区限制：若所在地区无法访问YouTube，或网络代理配置异常，也会导致Pytube无法获取视频信息。

修正方案 #

1. 修复UI初始化问题 #

添加customtkinter应用实例的初始化代码，并启动主事件循环。

2. 细化异常捕获，输出具体错误 #

将宽泛的except:改为捕获特定异常，并打印具体错误信息，便于精准定位问题。

3. 更新Pytube到最新版本 #

执行命令更新Pytube，适配YouTube最新页面结构：

pip install --upgrade pytube

修正后的完整代码 #

import customtkinter
import tkinter
from pytube import YouTube
from pytube.exceptions import RegexMatchError, VideoUnavailable


def startdownload():
    try:
        ytLink = Link.get().strip()  # 去除首尾空格，避免空输入或无效空格
        if not ytLink:
            print("请输入有效的YouTube链接")
            return
            
        ytObject = YouTube(ytLink)
        # 打印视频标题，验证是否成功解析链接
        print(f"正在下载：{ytObject.title}")
        video = ytObject.streams.get_highest_resolution()
        video.download()
        print("下载完成")
    except RegexMatchError:
        print("输入的链接格式无效，请检查是否为正确的YouTube链接")
    except VideoUnavailable:
        print("该视频不可用（可能已删除或存在地区限制）")
    except Exception as e:
        print(f"下载出错：{str(e)}")


# 初始化customtkinter应用
app = customtkinter.CTk()
app.title("YouTube视频下载器")
app.geometry("400x200")

# UI元素添加
title = customtkinter.CTkLabel(app, text="Insert a youtube link")
title.pack(padx=10, pady=10)

# 链接输入框
url_var = tkinter.StringVar()
Link = customtkinter.CTkEntry(app, width=350, height=40, textvariable=url_var)
Link.pack()

# 下载按钮
download = customtkinter.CTkButton(app, text="Download", command=startdownload)
download.pack(padx=10, pady=10)

# 启动主循环
app.mainloop()

额外提示 #

• 确保输入的是完整的YouTube视频链接（如https://www.youtube.com/watch?v=xxxxxx）
• 若存在网络限制，需确保网络可正常访问YouTube
• 针对需要登录才能访问的视频，可尝试添加OAuth验证：

  ytObject = YouTube(ytLink, use_oauth=True, allow_oauth_cache=True)
  

内容的提问来源于stack exchange，提问作者mr. code