如何将Firestore中包含嵌套集合的指定完整集合迁移至另一个Firebase项目

兄弟，我太懂你这种需求了！在开发环境里打磨好带嵌套集合的数据集，现在要迁到生产项目给用户用，这操作太常见了。给你整理了三个靠谱的方案，你根据自己的技术熟悉程度挑就行：

方案一：用Firebase控制台可视化操作（适合新手，不用写代码） #

• 第一步：打开开发项目的Firestore控制台，找到「导出数据」选项。勾选你要迁移的目标集合，一定要记得开启「包含嵌套集合」的选项（不然子集合会被漏掉），导出格式选Firestore原生格式，把文件导出到开发项目绑定的Cloud Storage存储桶里。
• 第二步：把导出的文件夹复制到生产项目的Cloud Storage存储桶里。你可以在Cloud Storage控制台直接操作复制，或者用gsutil cp -r命令行复制，记得给生产项目的服务账号设置访问开发项目存储桶的权限，不然复制不了。
• 第三步：打开生产项目的Firestore控制台，找到「导入数据」选项，选择刚才复制过来的导出文件夹，指定目标集合的名称（可以和原集合同名，也可以按需修改），确认后就会开始导入，嵌套集合会自动跟着导过去。

温馨提示：导入前最好备份生产项目对应区域的Firestore数据，防止出现意外情况。

方案二：用gcloud命令行工具（适合喜欢高效操作的用户） #

• 首先确保你已经安装了Google Cloud SDK，并且能正常登录两个项目的账号（用gcloud config set project [项目ID]可以快速切换项目）。
• 导出命令：切换到开发项目后，执行gcloud firestore export gs://[开发项目存储桶路径] --collection-ids=[要迁移的集合名]，这个命令会自动把指定集合（包括所有嵌套子集合）导出到指定的存储桶文件夹里。
• 复制导出文件：用gsutil cp -r gs://[开发项目存储桶]/[导出的文件夹名] gs://[生产项目存储桶]/把导出内容复制到生产项目的存储桶。
• 导入命令：切换到生产项目后，执行gcloud firestore import gs://[生产项目存储桶]/[导出的文件夹名]，等待导入完成即可。

注意：如果生产项目里已经存在同名集合，导入操作会自动合并数据；如果你想要完全覆盖，建议先清空目标集合再导入。

方案三：写自定义Node.js脚本（适合需要自定义迁移逻辑的场景） #

如果迁移时需要修改部分数据，或者对迁移过程有特殊要求，可以用Firebase Admin SDK写个简单的递归脚本：

• 先准备好开发和生产项目的服务账号密钥文件（在Firebase控制台的「项目设置-服务账号」里可以下载）。
• 安装依赖：npm install firebase-admin
• 写递归迁移的脚本（核心是递归处理嵌套集合），示例代码如下：

const admin = require('firebase-admin');

// 初始化开发项目Admin实例
const devApp = admin.initializeApp({
  credential: admin.credential.cert('./dev-service-account.json'),
}, 'dev');
const devFirestore = devApp.firestore();

// 初始化生产项目Admin实例
const prodApp = admin.initializeApp({
  credential: admin.credential.cert('./prod-service-account.json'),
}, 'prod');
const prodFirestore = prodApp.firestore();

// 递归迁移集合的函数
async function migrateCollection(sourceColPath, targetColPath) {
  const docSnapshot = await devFirestore.collection(sourceColPath).get();
  // 批量写入文档，避免单次写入过多触发限制
  const batch = prodFirestore.batch();
  let batchCount = 0;

  for (const doc of docSnapshot.docs) {
    const targetDocRef = prodFirestore.doc(`${targetColPath}/${doc.id}`);
    batch.set(targetDocRef, doc.data());
    batchCount++;

    // 每500条提交一次批量操作（Firestore批量操作上限）
    if (batchCount >= 500) {
      await batch.commit();
      batchCount = 0;
    }

    // 递归处理当前文档下的所有嵌套子集合
    const subcollections = await doc.ref.listCollections();
    for (const subcol of subcollections) {
      await migrateCollection(
        `${sourceColPath}/${doc.id}/${subcol.id}`,
        `${targetColPath}/${doc.id}/${subcol.id}`
      );
    }
  }

  // 提交剩余的批量操作
  if (batchCount > 0) {
    await batch.commit();
  }
}

// 启动迁移，替换成你的目标集合名称
migrateCollection('你的源集合名', '你的目标集合名')
  .then(() => console.log('迁移完成！'))
  .catch(err => console.error('迁移出错：', err));

• 运行脚本：node migrate.js，等待迁移完成即可。

备注：内容来源于stack exchange，提问作者Pastudent