Firestore数据仅会话内可见，未同步至数据库问题求助

核心问题定位 #

你遇到的是Firestore本地缓存与云端数据不同步的典型情况：写操作仅更新了客户端本地缓存，并未成功同步到云端，因此仅当前会话可见，退出登录后本地缓存被清空，修改内容消失。

关于项目运行时长的疑问 #

项目创建于30天前、昨夜保持运行这两个因素不会直接导致该问题。Firebase免费项目不会因30天未使用被冻结（通常数月无活动才会触发休眠），持续运行也不会引发数据同步异常，无需为此担心。

可能的原因及排查方案 #

• 未正确处理写操作的异步Promise
  Firestore所有写操作都是异步的，若代码中未等待Promise完成、也未捕获错误，会出现“本地缓存更新但云端写入失败”的假象。必须确保写操作的错误被捕获：

  // 错误示例：无错误处理，无法感知写入失败
  db.collection("your-collection").doc("doc-id").update({ field: "value" });
  
  // 正确写法：捕获错误并排查
  db.collection("your-collection").doc("doc-id").update({ field: "value" })
    .then(() => console.log("云端写入成功"))
    .catch((error) => console.error("写入失败原因:", error));
  

  查看浏览器控制台的错误日志，通常能找到写入失败的具体原因（如权限问题、字段格式错误等）。

• 离线持久化异常
  虽然你未手动创建本地副本，但Web SDK在部分场景下可能意外启用离线持久化（或代码中误调用了enablePersistence()）。若持久化开启后，网络中断或云端写入失败，本地缓存的修改无法同步到云端，会出现会话内可见、云端无变化的情况。
  可尝试临时禁用持久化测试：

  firebase.firestore().settings({ persistence: false });
  

  若禁用后问题消失，说明是持久化同步异常，可进一步检查网络状态或调整持久化配置。

• 写操作触发时权限验证失败
  你的Firestore规则允许登录用户读写，但需确认写操作触发时用户确实处于登录状态。若写操作执行时auth状态尚未初始化完成（如页面加载早期），会导致请求被规则拒绝，但本地缓存仍会临时更新。可在写操作前先校验auth状态：

  const user = firebase.auth().currentUser;
  if (user) {
    // 执行写操作
  } else {
    console.log("用户未登录，无法执行写入");
  }
  

• 检查云端写入记录
  登录Firebase控制台，进入Firestore的监控->使用情况页面，查看写操作的成功率；或打开浏览器Network面板，过滤firestore.googleapis.com的请求，检查写请求的返回状态码，确认是否存在云端拒绝的情况。

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