Firebase Storage视频转存YouTube失败排查及替代方案咨询

先来说说你的代码里可能踩的几个坑，以及对应的修复方式：

1. 异步操作未正确等待（最可能的核心原因） #

Firebase Functions是无服务器异步运行环境，你的代码用回调函数处理YouTube上传，但如果没有让Functions等待这个异步操作完成，函数会在上传还没结束、回调还没执行的时候就提前终止——自然看不到日志，上传也会中途失败。

另外你在回调里直接调用process.exit()，这在Functions环境里完全没必要：Functions会自动管理生命周期，强制退出会导致日志无法正常上报，甚至直接中断未完成的操作。

修复方式：改用async/await（推荐） #

YouTube API的方法本身支持Promise风格（只要不传入回调函数），改成async函数包裹，让Functions等待上传完成：

exports.uploadToYouTube = functions.storage.object().onFinalize(async (object) => {
  const bucket = admin.storage().bucket();
  const vfile = bucket.file('/videos/test.MOV');

  try {
    const data = await youtube.videos.insert({
      resource: {
        snippet: { 
          title: "Testing YoutTube API NodeJS module", 
          description: "Test video upload via YouTube API" 
        },
        status: { privacyStatus: "private" }
      },
      part: "snippet,status",
      media: { body: vfile.createReadStream() }
    });
    functions.logger.log("上传成功:", data);
  } catch (err) {
    functions.logger.error("上传失败:", err);
  }
});

2. 服务账号的YouTube权限配置缺失 #

服务账号本身没有默认关联的YouTube频道，你必须完成两个关键配置：

• 启用YouTube Data API v3：在Google Cloud Console的API库中搜索并启用YouTube Data API v3。
• 关联目标YouTube频道：
  1. 在Google Cloud Console的凭据页面找到你的服务账号，复制它的邮箱地址。
  2. 登录你要迁移视频的YouTube频道后台，把这个服务账号邮箱添加为频道的管理员。
  3. 创建服务账号密钥时，务必勾选https://www.googleapis.com/auth/youtube.upload权限范围。

3. 文件流的错误未被捕获 #

vfile.createReadStream()如果读取失败（比如文件不存在、存储桶权限不足），流会抛出错误，但你的代码没有监听这个错误事件，导致错误被静默吞掉，既不会触发YouTube API的回调，也不会输出任何日志。

修复方式：监听流的error事件 #

const fileStream = vfile.createReadStream();
fileStream.on('error', (err) => {
  functions.logger.error("读取存储桶文件失败:", err);
  throw err; // 让async函数捕获这个错误，进入catch分支
});

// 再把fileStream传给youtube.videos.insert的media.body

替代方案：用临时URL直接上传 #

如果不想处理流的复杂逻辑，你可以给Firebase Storage的文件生成一个临时可访问URL，让YouTube API直接从这个URL拉取文件：

const [url] = await vfile.getSignedUrl({
  action: 'read',
  expires: '03-09-2025' // 设置合理的临时过期时间
});

const data = await youtube.videos.insert({
  resource: { /* 保持之前的snippet和status配置 */ },
  part: "snippet,status",
  media: { body: url }
});

这种方式更简洁，不需要处理流的错误，适合大多数迁移场景。

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