如何将Firebase Storage Emulator中的Blob上传至Firebase Cloud Storage

前置准备 #

• 确保本地已安装最新版firebase-tools，版本≥11.0.0，低版本不支持模拟器存储的批量导出功能
• 已完成生产环境Firebase项目的身份验证，本地执行firebase login登录对应账号，且账号具备Storage的写入权限
• 提前停用生产环境Storage的权限限制规则，或者临时给当前账号配置storage.admin权限，避免迁移时报权限错误

方案1：官方CLI导出导入（无定制需求首选，操作最简） #

不需要自行编写代码，可完整保留文件的自定义元数据、访问权限配置，操作步骤最少：

1. 保持Firebase模拟器运行状态，执行导出命令将模拟器存储数据导出到本地：
   firebase emulators:export ./emulator-export-data --only storage
   执行后导出的所有文件、元数据会存储在本地./emulator-export-data目录下
2. 执行导入命令将本地导出的存储数据上传到云端生产环境：
   firebase storage:import ./emulator-export-data/storage_export --project <你的生产项目ID>

注意：如果需要覆盖云端已存在的同名文件，可追加参数--force；如果仅需要导入云端不存在的文件则无需添加该参数

方案2：Node.js脚本批量迁移（适合需要过滤文件、修改元数据等定制场景） #

如果迁移过程需要筛选指定路径的文件、修改文件名/元数据、添加迁移进度统计等定制逻辑，可采用脚本方案：

1. 首先安装依赖：npm install firebase-admin
2. 核心迁移代码示例：

const admin = require('firebase-admin');
const { readFileSync, readdirSync, statSync } = require('fs');
const { join } = require('path');

// 初始化生产环境Admin SDK
const serviceAccount = require('./你的生产环境服务账号密钥.json');
admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  storageBucket: '<你的生产存储桶地址>.appspot.com'
});
const bucket = admin.storage().bucket();

// 模拟器导出的存储文件本地目录
const emulatorStorageDir = './emulator-export-data/storage_export/blobs';

// 批量上传逻辑
async function migrateFiles() {
  const files = readdirSync(emulatorStorageDir);
  for (const file of files) {
    const filePath = join(emulatorStorageDir, file);
    if (statSync(filePath).isFile()) {
      // 还原文件在Storage中的原始路径，模拟器导出时会对特殊字符做编码处理
      const cloudFilePath = decodeURIComponent(file.replace(/%2F/g, '/'));
      // 可在此处添加自定义过滤逻辑，不符合条件的文件跳过上传
      // 上传到云端存储
      await bucket.upload(filePath, {
        destination: cloudFilePath,
        // 可在此处自定义元数据配置
        metadata: {
          cacheControl: 'public, max-age=31536000'
        }
      });
      console.log(`已迁移：${cloudFilePath}`);
    }
  }
}

migrateFiles().then(() => console.log('全部文件迁移完成')).catch(console.error);

迁移校验 #

• 迁移完成后执行firebase storage:ls gs://<你的存储桶地址> --recursive查看所有文件是否均已上传
• 随机抽取多个文件核对文件大小、元数据、访问链接是否正常
• 恢复之前临时修改的Storage权限规则，关闭额外配置的admin权限

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