手动删除重建Firebase Firestore集合后单个集合无法读取问题

以下是按优先级排序的排查操作：

• 核对集合名称拼写：Firestore 集合名称大小写敏感，手动重建时极易出现拼写偏差（比如多了空格、大小写错误），直接复制 Firebase 控制台内的集合名称替换代码内的对应字段，排除手敲错误。
• 校验安全规则配置：删除旧集合后，原有针对该集合配置的读写规则可能未生效，也可能存在规则范围不匹配的问题，你可以先临时给对应集合开放测试权限验证：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /你无法读取的集合名/{doc=**} {
      allow read, write: if request.time < timestamp.date(2024, 12, 31);
    }
  }
}

如果配置后可以正常读取，说明是安全规则问题，调整对应正式规则即可，测试完成后务必删除临时测试规则避免数据泄露。

• 清理本地缓存：如果你的应用开启了 Firestore 离线持久化，本地可能缓存了旧集合删除后的空数据，可先卸载应用重装测试，或调用 clearPersistence() 方法主动清理本地缓存。
• 校验文档与解析逻辑：手动创建的文档需确认字段名大小写、数据类型和代码中的实体类完全匹配，比如文档字段为createTime，代码中写createtime就会导致解析失败，看起来像没有查询到数据。你可以在查询代码中添加日志打印查询到的原始快照数量，判断是真的没有查询到数据还是解析失败：

// Android 示例代码
db.collection("目标集合名")
  .get()
  .addOnSuccessListener(snapshot -> {
      Log.d("Firestore调试", "查询到的文档数量：" + snapshot.size());
      if (!snapshot.isEmpty()) {
          // 有数据，排查后续解析逻辑
      }
  })
  .addOnFailureListener(e -> {
      Log.e("Firestore调试", "查询报错", e);
  });

通过报错日志可以直接定位是权限问题、集合不存在还是其他异常。

内容的提问来源于stack exchange，提问作者Namuganga Emmilly Immaculate