将JSON导入Firebase Firestore遇阻：求助云函数脚本修复

我帮你梳理几个Maciej那个迁移脚本常见的故障点和解决办法，都是实际做这类迁移时踩过的坑：

一、先检查权限配置，这是最容易忽略的点 #

• 你的Cloud Function服务账号得同时拥有实时数据库的读取权限和Firestore的写入权限才行。
• 最快的解决方式是在Google Cloud控制台的IAM页面，给对应服务账号加上Firebase Admin SDK Administrator Service Agent角色——这个角色基本涵盖了迁移需要的所有权限，不用一个个单独加。

二、适配实时数据库和Firestore的数据结构差异 #

实时数据库的JSON结构和Firestore的文档规则不太一样，很多脚本报错都是因为这个：

• 如果你的数据嵌套层级超过100层，Firestore会直接拒绝写入，得提前写个小工具把深层嵌套的结构扁平化。
• 要是实时数据库里有那种用连续数字当键的“类数组”对象，Firestore会把它当成普通映射而非数组，你可以加个转换函数修正：

  // 把实时数据库的类数组对象转成Firestore认可的数组
  function fixArrayStructure(obj) {
    if (typeof obj !== 'object' || obj === null) return obj;
    const keys = Object.keys(obj);
    // 判断是否是连续数字索引的类数组
    const isArrayLike = keys.every(key => {
      const num = parseInt(key);
      return !isNaN(num) && num >= 0 && num === keys.length - 1;
    });
    if (isArrayLike) {
      return keys.map(key => fixArrayStructure(obj[key]));
    }
    // 普通对象则递归处理嵌套
    const processedObj = {};
    for (const key of keys) {
      processedObj[key] = fixArrayStructure(obj[key]);
    }
    return processedObj;
  }
  

三、处理Firestore批量写入的500文档限制 #

Firestore的批量操作一次最多只能处理500个文档，原脚本如果没做分批处理，数据量一大就会报错：

• 把批量写入逻辑改成分批提交的方式，示例代码如下：

  async function batchWriteToFirestore(db, documentMap) {
    const batchPromises = [];
    let currentBatch = db.batch();
    let docCount = 0;
  
    for (const [docPath, data] of Object.entries(documentMap)) {
      const docRef = db.doc(docPath);
      currentBatch.set(docRef, data);
      docCount++;
  
      if (docCount === 500) {
        batchPromises.push(currentBatch.commit());
        currentBatch = db.batch();
        docCount = 0;
      }
    }
    // 提交最后一批不足500的文档
    if (docCount > 0) {
      batchPromises.push(currentBatch.commit());
    }
    await Promise.all(batchPromises);
  }
  

四、解决大数据量下的读取超时问题 #

如果你的实时数据库数据量很大，一次性拉取全量数据会触发Cloud Function的超时：

• 改用分页读取或者按节点拆分读取，比如先读取一级节点，再逐个读取子节点，避免一次性加载过多数据。
• 同时可以调整Cloud Function的超时时间，默认是1分钟，部署时可以设置到最长9分钟：

  gcloud functions deploy your-migration-function --timeout=540s --runtime=nodejs18
  

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