如何将Firestore集合下载至本地处理后重新上传？解决格式异常问题

解决Gcloud Console导出文件无法打开的问题 #

通过Gcloud Console导出的Firestore集合是原始导出数据包（包含LevelDB格式的底层文件），并非直接可读的JSON或文本格式，因此无法直接打开编辑。建议使用以下两种更易用的方式导出可读格式数据：

方式一：使用Firebase CLI（推荐，适合快速导出/导入） #

导出步骤 #

1. 安装Firebase CLI：

   npm install -g firebase-tools
   

2. 登录你的Firebase账号：

   firebase login
   

3. 导出指定集合到本地（生成可读JSON文件）：

   firebase firestore:export ./local-firestore-data --collection-ids=你的集合名称
   

   执行后，local-firestore-data目录下会生成对应集合的JSON文件，直接可用文本编辑器打开编辑。

本地处理注意事项 #

• 编辑时保留Firestore的文档结构：如果需要保留原文档ID，确保每个文档对象包含__name__字段（格式为projects/[项目ID]/databases/(default)/documents/[集合名]/[文档ID]）
• 特殊数据类型（如Timestamp、GeoPoint）需保持Firestore兼容格式，例如Timestamp需写成{"_seconds": 1620000000, "_nanoseconds": 0}

重新上传到Firestore #

处理完成后，执行导入命令：

firebase firestore:import ./local-firestore-data/处理后的文件.json --collection-ids=目标集合名称

方式二：使用gcloud命令行工具（适合大规模数据操作） #

导出步骤 #

1. 将集合导出到Cloud Storage：

   gcloud firestore export gs://你的云存储桶路径 --collection-ids=你的集合名称
   

2. 将导出的文件下载到本地：

   gsutil cp -r gs://你的云存储桶路径/导出的文件夹名 ./本地目录
   

3. 转换为可读格式：
   可以使用firestore-export-import工具（Node.js）将原始导出文件转为JSON：

   npm install -g firestore-export-import
   firestore-export -a 你的服务账号密钥.json -b ./导出的文件夹名 -o 输出的JSON文件名.json
   

重新上传步骤 #

1. 将处理后的JSON文件转换为Firestore导入格式（使用同工具）：

   firestore-import -a 你的服务账号密钥.json -b 处理后的JSON文件名.json
   

2. 将转换后的文件上传到Cloud Storage：

   gsutil cp -r ./转换后的文件夹 gs://你的云存储桶路径
   

3. 导入到Firestore：

   gcloud firestore import gs://你的云存储桶路径/转换后的文件夹
   

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