如何将Firebase数据存储从Realtime DB切换至Firestore

首先明确核心逻辑：Firebase 不会自动将 Realtime Database 的 API 请求转发到 Firestore，你之前必须启用 Realtime Database 才能读写的原因是现有代码调用的全部是 Realtime Database 的专属接口，和是否激活 Firestore 无关。

1. 调整项目依赖与初始化逻辑 #

• 移除项目中 Realtime Database 的相关依赖，替换为 Firestore 依赖，以 Web 端为例：
  替换前（Realtime Database 依赖）：

  import { getDatabase } from "firebase/database";
  

  替换后（Firestore 依赖）：

  import { getFirestore } from "firebase/firestore";
  

• 调整 Firebase 初始化代码，初始化 Firestore 实例而非 Realtime Database 实例：

  // 原有初始化 Realtime Database 代码可删除
  // const database = getDatabase(app);
  // 新增 Firestore 初始化
  const db = getFirestore(app);
  

2. 替换所有数据读写逻辑 #

Realtime Database 是树状 JSON 结构，Firestore 是「集合-文档」二级结构，读写 API 完全不同，需要逐处替换：

• 单条数据写入对比：
  原有 Realtime Database 写法：

  import { ref, set } from "firebase/database";
  set(ref(database, 'users/' + userId), { username: name });
  

  替换为 Firestore 写法：

  import { doc, setDoc } from "firebase/firestore";
  setDoc(doc(db, 'users', userId), { username: name });
  

• 单条数据读取对比：
  原有 Realtime Database 写法：

  import { ref, get } from "firebase/database";
  const snap = await get(ref(database, 'users/' + userId));
  const data = snap.val();
  

  替换为 Firestore 写法：

  import { doc, getDoc } from "firebase/firestore";
  const snap = await getDoc(doc(db, 'users', userId));
  const data = snap.data();
  

注意：如果有用到实时监听、条件查询、批量写入等功能，对应 API 都需要替换为 Firestore 专属的接口，无需保留任何 Realtime Database 相关的导入和调用

3. 调整安全规则配置 #

• 进入 Firebase 控制台的 Firestore 板块，打开「规则」页，按照你的业务权限需求编写 Firestore 规则，原 Realtime Database 的规则不能直接复用，需要对应调整：
  例如原 Realtime Database 允许所有读写的规则：

  {
    "rules": {
      ".read": true,
      ".write": true
    }
  }
  

  对应 Firestore 的写法为：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow read, write: if true;
      }
    }
  }
  

测试阶段可以先放开权限，验证功能正常后再收紧规则到符合业务安全要求

4. 现有数据迁移（可选） #

如果 Realtime Database 中已有存量数据需要迁移到 Firestore，按以下步骤操作：

• 进入 Firebase 控制台 Realtime Database 板块，导出数据为 JSON 文件
• 根据 Firestore 的集合-文档结构整理导出的 JSON 数据
• 通过 Firestore 批量写入 API 或者控制台手动导入的方式，将数据写入 Firestore

5. 验证切换结果 #

• 所有逻辑修改完成后，可以在 Firebase 控制台临时关闭 Realtime Database 的权限（设置所有读写为false），测试应用的所有数据读写功能是否正常
• 查看 Firestore 控制台的数据变化，确认新写入的数据都存储在 Firestore 中，即切换完成

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