使用YouTube API上传视频时出现“Processing abandoned The video could not be processed”错误的原因及解决方法

首先来看你的场景和代码：

我尝试用YouTube API上传视频，代码片段如下：

var request: any = await Youtube.videos.insert({ 
  resource: { 
    snippet: { title: title , description: description } , 
    status: { privacyStatus: "private" } 
  } , 
  part: "snippet,status" , 
  media: { body: fs.createReadStream(file) } 
}, (err: any, data: any) => { 
  if (err) { 
    console.log(err.response.data.error) 
  } 
  console.log("Video upload to youtube Successfull."); 
});

但上传后在YouTube频道看到“Processing abandoned The video could not be processed”错误，请问这是什么原因？该怎么解决？

这个错误通常是上传的视频数据不完整、格式不符合要求，或者请求逻辑存在异常导致的，下面分点给你分析原因和对应的解决方法：

可能的原因及修复步骤 #

1. 视频文件格式/编码不被YouTube支持 #

YouTube对视频的编码规范有明确要求：推荐使用H.264视频编码、AAC-LC音频编码，容器格式优先MP4。如果你的视频文件不符合这些标准，YouTube的处理系统会直接放弃。

• 解决方法：
  • 先用FFmpeg检查视频的编码信息：

    ffmpeg -i your-video-file.mp4
    

  • 如果不符合要求，转码成合规格式，比如执行：

    ffmpeg -i input-file.avi -c:v libx264 -crf 23 -c:a aac -b:a 128k output-file.mp4
    

2. 视频文件读取流异常 #

你用fs.createReadStream(file)读取文件，但如果文件路径错误、文件损坏，或者读取时出现权限问题，会导致上传的数据流不完整，YouTube无法解析。

• 解决方法：
  • 先确认file变量的路径绝对正确，手动检查文件是否存在且能正常打开
  • 给读取流添加错误监听，排查读取阶段的问题：

    const fileStream = fs.createReadStream(file);
    fileStream.on('error', (err) => {
      console.error('读取视频文件出错:', err);
    });
    // 再把fileStream传入media.body
    

3. API请求的异步处理逻辑冲突 #

你的代码同时混用了await和回调函数，这种写法会导致逻辑异常：比如上传过程中出现错误时，回调和await的错误捕获可能冲突，你误以为上传成功，但实际数据流并没有完整传输到YouTube。

• 解决方法：
  • 统一使用Promise风格，用try/catch捕获所有错误：

    try {
      const data = await Youtube.videos.insert({
        resource: {
          snippet: { title: title, description: description },
          status: { privacyStatus: "private" }
        },
        part: "snippet,status",
        media: { body: fs.createReadStream(file) }
      });
      console.log("视频上传成功:", data.data);
    } catch (err) {
      console.error('上传失败:', err.response?.data?.error || err.message);
    }
    

  这样能准确捕获API返回的具体错误信息，帮你更快定位问题。

4. 大文件上传未用分片机制 #

如果你的视频文件很大，普通上传容易因为网络波动超时，导致传输中断，YouTube拿到不完整的文件就会处理失败。

• 解决方法：
  • 改用YouTube API支持的可恢复上传（resumable upload），同时添加进度监听：

    const request = Youtube.videos.insert({
      resource: {
        snippet: { title: title, description: description },
        status: { privacyStatus: "private" }
      },
      part: "snippet,status",
      media: { body: fs.createReadStream(file) }
    }, {
      onUploadProgress: (event) => {
        const progress = Math.round((event.bytesRead / event.totalBytes) * 100);
        console.log(`上传进度: ${progress}%`);
      }
    });
    
    try {
      const data = await request;
      console.log("上传成功:", data.data);
    } catch (err) {
      console.error('上传失败:', err);
    }
    

5. API权限或配额问题 #

虽然概率较低，但如果你的API项目配额不足，或者OAuth2授权时没有请求https://www.googleapis.com/auth/youtube.upload权限，也可能导致上传后处理失败。

• 解决方法：
  • 去Google Cloud Console检查YouTube Data API的配额是否还有剩余
  • 确认OAuth2授权流程中，请求的权限范围包含youtube.upload

内容的提问来源于stack exchange，提问作者Süleyman Ali Akpınar