Firestore emulator数据无法持久化存储 仅从缓存返回问题咨询

临时文档存储位置 #

你通过代码查询到的未同步数据，全部存储在当前应用运行进程的Firestore SDK离线内存缓存中，没有成功写入到模拟器的存储层。

无法同步到模拟器的常见原因及排查方案 #

• 模拟器连接配置错误 #

  这是最高发的问题，确保你初始化Firestore实例时显式指定了模拟器地址，且IP、端口完全匹配模拟器启动时的配置：

  const db = getFirestore(app);
  // 禁止用localhost替代127.0.0.1，避免端侧解析异常
  connectFirestoreEmulator(db, "127.0.0.1", 8080);
  

  配置错误时SDK会静默进入离线模式，所有读写操作仅操作本地缓存，不会和模拟器交互，自然不会在模拟器UI展示变更。

• SDK缓存配置异常 #

  如果代码中存在以下配置，会导致SDK不走网络同步：

  1. 调用过disableNetwork(db)手动关闭了SDK的网络连接
  2. 查询时指定了source: 'cache'参数，强制仅读取本地缓存，不会拉取模拟器的最新数据（你删除文档后仍能查到就是这个原因）
  3. 安全规则拦截写入请求后，SDK会自动将写入操作暂存到本地缓存，等待权限恢复后重试，此时也会出现写入成功但模拟器无感知的情况。

• 模拟器本身的持久化配置 #

  Firestore模拟器默认重启即清空所有数据，如果你需要模拟器重启后仍保留测试数据，启动时需要添加持久化参数：

  # 启动时导入历史数据，退出时自动保存当前数据
  firebase emulators:start --import=./local-emulator-data --export-on-exit=./local-emulator-data
  

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