使用ytdl-core拉取YouTube音频时遇miniget抛出404错误如何解决
ytdl-core拉取YouTube音频触发miniget 404错误解决方案
核心原因
ytdl-core依赖的YouTube资源接口规则会频繁更新,旧版本的包无法适配新的接口签名校验规则,就会触发底层依赖miniget请求资源时返回404。
修复步骤
- 升级ytdl-core到最新正式版,维护者会及时跟进YouTube的接口变化,大部分情况升级后即可解决问题:
# npm 环境 npm install ytdl-core@latest # pnpm 环境 pnpm add ytdl-core@latest - 升级后仍报错的话,在调用时添加浏览器UA请求头,绕过基础的请求校验:
ytdl("https://www.youtube.com/watch?v=" + stream.id, { requestOptions: { headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36' } } }); - 补全错误捕获逻辑,避免未处理的Promise异常导致进程崩溃:
const audioStream = ytdl("https://www.youtube.com/watch?v=" + stream.id); audioStream.on('error', err => { console.error('资源拉取失败:', err.message); // 此处补充自定义降级逻辑,比如跳过当前视频、返回兜底资源等 }); - 确认传入的
stream.id有效,将拼接后的完整视频URL放到浏览器直接访问,排查是否存在视频被删除、设为私密、地域限制等问题。
内容的提问来源于stack exchange,提问作者fir4tozden
相关产品推荐
相关产品推荐

