Firestore读取已删除文档字段、应用更新数据未同步到Firebase控制台问题

这个问题既不是Firebase控制台故障导致，也大概率不是Firestore规则引发，核心原因符合Firestore离线持久化的特性表现，你可以按以下步骤排查：

问题核心原理 #

Firestore默认开启离线持久化机制，所有读写操作都会优先读写本地缓存：

• 你在控制台修改的是服务端数据，应用没有触发服务端同步的情况下，会一直返回本地缓存的旧文档、旧字段
• 你在应用内更新数据时，会先写入本地缓存，所以应用内可以正常展示，但数据没有成功同步到服务端，自然不会在控制台显示

排查步骤 #

• 首先验证缓存问题：修改单文档查询代码，强制指定从服务端拉取数据，测试是否能拿到控制台更新后的内容

  // 强制从服务端拉取，不走本地缓存
  db.collection("chats").document("GsGFZGaQnT2ypp1rvfAx").get(Source.SERVER)
          .addOnSuccessListener {
              Log.i("chats document","$it")
          }.addOnFailureListener {
              Log.e("chats error", it.message.toString())
          }
  

  如果调用后可以拿到最新数据，说明是本地缓存同步问题；如果报PERMISSION_DENIED错误，才是Firestore规则配置问题；如果报连接类错误，说明应用和Firebase服务端连通性异常。
• 排查规则问题：临时放开chats集合的读写权限测试，排除规则拦截：

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

  测试完成后务必恢复原有权限配置。
• 清理本地缓存：卸载应用重装，清除本地存储的所有离线缓存和待同步的写队列，重启后再测试数据同步是否恢复正常。
• 检查写操作回调：给应用内的更新逻辑添加失败回调，确认是否存在字段类型不匹配、文档不存在、配额超限等写操作报错。

最终判断标准 #

• 如果强制读服务端正常，只是本地缓存读取旧数据：属于离线持久化的正常表现，可在快照回调中判断snapshot.metadata.isFromCache字段，区分返回结果来源决定是否展示。
• 如果所有服务端请求都报权限错误：属于Firestore规则配置问题，检查规则中是否对chats集合的读写做了身份、字段相关限制。
• 如果服务端请求报连接/认证错误：检查应用的Firebase配置是否正确，包名、SHA签名、google-services.json是否和控制台配置一致，当前网络是否可以访问Firebase服务。

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