Firestore项目克隆：如何导出导入至新项目供开发者测试？

当然可行！这种通过导出/导入隔离测试环境和生产环境的方式，是我们团队给开发者搭建测试环境的常用方案，完全能避免测试操作影响原项目数据。下面给你详细拆解操作步骤和注意事项：

一、导出原Firestore项目数据 #

你可以通过Firebase控制台或gcloud命令行两种方式导出，选你顺手的就行：

控制台操作步骤 #

• 打开Firebase控制台，进入你的原生产项目
• 左侧菜单找到「Firestore数据库」，切换到「导入/导出」标签页
• 在「导出」区域，选择要导出的集合——如果要完整克隆就选全部，要是只需要测试部分数据，也可以指定特定集合
• 选择存储导出文件的Cloud Storage Bucket（如果还没有，点击提示创建一个就行，注意区域尽量和原Firestore数据库一致）
• 点击「导出」按钮，耐心等系统完成导出（时间长短取决于数据量大小）

gcloud命令行操作 #

如果习惯用命令行批量操作，这会更高效：

• 先确保你已经安装并初始化了gcloud CLI，并且关联了原项目（用gcloud config set project [原项目ID]切换）
• 运行导出命令：

  # 导出全部集合
  gcloud firestore export gs://[你的存储桶名称]
  
  # 导出指定集合（比如users、orders）
  gcloud firestore export gs://[你的存储桶名称] --collection-ids=users,orders
  

  导出完成后，存储桶里会生成一个带时间戳的文件夹，里面包含所有导出的数据文件和元数据。

二、导入数据到新Firestore项目 #

导出完成后，就可以把数据导入到你的新测试项目了：

控制台操作步骤 #

• 打开Firebase控制台，进入新测试项目，先确保已经创建了Firestore数据库（数据库位置建议和原项目一致，避免后续索引或性能问题）
• 同样进入「Firestore数据库」的「导入/导出」标签页
• 在「导入」区域，选择刚才导出的存储桶里的目标文件夹（就是那个带时间戳的文件夹，系统会自动识别里面的firestore_export元数据文件）
• 确认要导入的集合（默认会导入所有导出的集合，也可以手动调整）
• 点击「导入」按钮，等待导入完成

gcloud命令行操作 #

• 先切换gcloud到新测试项目：gcloud config set project [新项目ID]
• 运行导入命令，指定导出文件的存储路径：

  gcloud firestore import gs://[你的存储桶名称]/[导出的时间戳文件夹名称]
  

三、必须注意的几个关键点 #

• 权限配置：操作账号要同时拥有原项目的Firestore读取权限、Cloud Storage写入权限，以及新项目的Firestore写入权限、Cloud Storage读取权限，不然会报错
• 数据一致性：导出过程中原项目如果有数据写入，导出的可能不是实时最新数据，建议在业务低峰期操作，或者暂时暂停生产写入（如果业务允许的话）
• 索引同步：导出会包含原项目的集合索引配置，导入时会自动创建这些索引，但要注意新项目的Firestore索引配额是否足够，不够的话需要调整
• 安全规则：新项目的Firestore安全规则不会自动同步，记得手动复制原项目的规则（或者根据测试需求放宽/调整，方便开发者测试）
• 费用说明：导出导入会产生Cloud Storage的存储费用和Firestore的操作费用，但测试项目数据量一般不大，成本几乎可以忽略不计

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