Firestore模拟器导入备份后150K文档集合为空问题求助

问题场景 #

拥有名为my-proj的Firebase项目，生产环境Firestore含153K条文档（50Mb），通过gcloud firestore export gs://my-proj.appspot.com/backup导出到存储桶，存储桶内备份完整（153K文档、50Mb）。使用gsutil -m cp -r gs://my-proj.appspot.com/backup ./data将备份复制到本地后，本地目录占用56M。启动模拟器firebase emulators:start --import ./data/backup后，模拟器界面显示所有集合，但含150K条文档的核心集合点击后为空，日志无报错；导入3K条文档（1.3Mb）的备份可正常运行。

排查与解决方法 #

1. 验证本地备份文件完整性 #

本地备份体积比存储桶中略大，可能存在文件复制不完整或损坏的情况：

• 使用gsutil -m rsync -c gs://my-proj.appspot.com/backup ./data/backup重新同步备份，-c参数会校验文件哈希值，确保本地文件与存储桶完全一致。
• 检查all_namespaces下对应核心集合的子目录，确认是否存在.export_metadata文件以及对应的文档数据分片文件（如output-00000-of-00001）。

2. 调整Firestore模拟器内存限制 #

大体积备份导入可能触发模拟器默认内存上限，导致部分数据未加载：

• 在项目根目录的firebase.json中添加模拟器内存配置：

{
  "emulators": {
    "firestore": {
      "port": 8080,
      "memory": "2G"
    }
  }
}

• 或者启动时直接指定内存参数：

firebase emulators:start --import ./data/backup --firestore.memory=2G

可根据机器配置调整为4G等更大值。

3. 直接从GCS存储桶导入，跳过本地复制 #

本地复制可能引入潜在问题，尝试让模拟器直接读取存储桶中的备份：

firebase emulators:start --import gs://my-proj.appspot.com/backup

确保本地已通过gcloud auth application-default login完成身份验证，拥有存储桶的读取权限。

4. 拆分备份分批导入 #

如果大备份一次性导入存在限制，可拆分核心集合单独导出和导入：

• 仅导出核心集合到存储桶：

gcloud firestore export gs://my-proj.appspot.com/backup-core --collection-ids=your-core-collection-name

• 先导入小集合备份，再单独导入核心集合备份：

firebase emulators:start --import ./data/backup-small
# 关闭模拟器后，再导入核心集合
firebase emulators:start --import ./data/backup-core

5. 检查Firebase CLI与模拟器版本兼容性 #

旧版本模拟器可能存在大文件导入的bug：

• 更新Firebase CLI到最新版本：

npm install -g firebase-tools

• 启动模拟器时查看版本信息，确认使用的是最新版Firestore模拟器。

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