如何用Python的yt_dlp模块快速检测YouTube视频是否不可用？

我给朋友的服务器开发了一款私人音乐机器人，功能运行正常，但在返回可选视频列表时，需先检查每个URL是否出错再加入选项列表，这一过程耗时约10秒（对于命令来说偏长）。当前实现代码如下：

# note: spyt is the list returned by the search function

for i in spyt:
    title=spyt[i]['title']
    url=spyt[i]['url']
    try:
        ytdl.extract_info(url,download=False)
    except yt_dlp.utils.DownloadError as e:
        # Skip unavailable videos
        continue
    except Exception as e:
        print(e)
    embed.add_field(name=f'{i+1}. {title}',value=url,inline=False)

运行时会输出大量下载日志：

[youtube] hz7rLaYW1l0: Downloading webpage
[youtube] hz7rLaYW1l0: Downloading android player API JSON
[youtube] kLESxX6Q2Lg: Downloading webpage
[youtube] kLESxX6Q2Lg: Downloading android player API JSON
[youtube] k3xM4bX2Q_Y: Downloading webpage
[youtube] k3xM4bX2Q_Y: Downloading android player API JSON
[youtube] k3xM4bX2Q_Y: Downloading MPD manifest
[youtube] k3xM4bX2Q_Y: Downloading MPD manifest
[youtube] dC5Vorucvbo: Downloading webpage
[youtube] dC5Vorucvbo: Downloading android player API JSON
[youtube] dC5Vorucvbo: Downloading MPD manifest
[youtube] dC5Vorucvbo: Downloading MPD manifest
[youtube] NWemYtvndWg: Downloading webpage
[youtube] NWemYtvndWg: Downloading android player API JSON
[youtube] NWemYtvndWg: Downloading MPD manifest
[youtube] NWemYtvndWg: Downloading MPD manifest

请问这些下载操作是否必要？是否存在更高效的方式，仅加载最少内容即可检测视频是否不可用？

优化方案 #

1. 当前的下载操作完全没必要 #

你现在调用extract_info(url, download=False)默认会拉取视频的完整元数据，包括网页、API JSON甚至MPD manifest——这些都是为了获取播放链接、分辨率等全量信息，但你只需要判断视频是否可用，完全不需要这么多内容，这就是耗时久的核心原因。

2. 两种高效检测方式 #

方式一：配置yt-dlp仅提取基础信息

通过设置yt-dlp的参数，限制只请求判断可用性所需的最小数据，同时关闭冗余日志：

# 初始化yt-dlp时配置优化选项
ytdl_opts = {
    'skip_download': True,
    'quiet': True,  # 关闭日志输出，避免冗余打印
    'extract_flat': True,  # 只提取基础元数据，不深入拉取播放资源信息
    'force_generic_extractor': False,
}
ytdl = yt_dlp.YoutubeDL(ytdl_opts)

# 建议用enumerate遍历列表，比按索引取更规范
for idx, item in enumerate(spyt):
    title = item['title']
    url = item['url']
    try:
        # 仅提取基础信息判断可用性
        ytdl.extract_info(url, download=False)
        embed.add_field(name=f'{idx+1}. {title}', value=url, inline=False)
    except yt_dlp.utils.DownloadError:
        # 视频不可用则跳过
        continue
    except Exception as e:
        print(f"检测视频[{url}]出错: {e}")

方式二：直接发送HTTP HEAD请求（更轻量）

如果只是快速判断URL是否可达、视频是否存在，可以跳过yt-dlp的复杂解析，用HTTP HEAD请求只获取响应头：

import requests

for idx, item in enumerate(spyt):
    title = item['title']
    url = item['url']
    try:
        # 发送HEAD请求，仅获取响应头，不下载页面内容
        response = requests.head(url, allow_redirects=True, timeout=3)
        # 有效视频页面通常返回200状态码
        if response.status_code == 200:
            embed.add_field(name=f'{idx+1}. {title}', value=url, inline=False)
    except requests.exceptions.RequestException:
        # 请求失败则跳过
        continue

注意：这种方式无法识别私有视频、地区限制视频这类“页面存在但无法播放”的情况，若需覆盖这类场景，还是要结合yt-dlp的轻量提取。

3. 额外提速建议 #

• 并行处理：如果待检测的视频数量较多，用多线程/异步请求同时处理多个URL，比如用concurrent.futures.ThreadPoolExecutor或aiohttp，能大幅缩短总耗时。
• 缓存结果：对已经检测过的URL缓存其可用状态，避免重复请求，减少不必要的网络开销。

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