离线时Cloud Firestore集合返回空的问题排查求助

核心问题原因 #

你的代码在线正常但离线返回空集合，大概率是忽略了Firestore离线缓存的几个关键前提：

• 缓存仅存储已成功获取的数据：Firestore不会预缓存未查询过的集合，必须在在线状态下成功加载过myCol1/myDoc1/myCol2集合，缓存中才会有数据。如果离线前从未加载过这个集合，或者加载失败，离线时自然返回空。
• 嵌套集合不会自动缓存：父文档myDoc1的缓存不会包含子集合myCol2的数据，必须显式执行过该子集合的查询，缓存才会存储它的内容。
• 持久化可能未正确开启：Expo环境中Firestore本地持久化默认开启，但部分版本或初始化配置可能导致它被关闭，需要显式确认。

解决步骤 #

1. 确保在线时完成数据缓存
   在线状态下先触发一次该集合的查询，确认数据成功加载（比如打印snapshot.docs.length确认有数据），Firestore会自动将数据写入本地缓存。

2. 显式开启本地持久化
   在App初始化阶段（首次调用Firestore方法前）添加持久化配置：

   import firestore from '@react-native-firebase/firestore';
   
   // 初始化时设置
   firestore().settings({
     persistence: true,
   });
   

3. 验证安全规则
   离线时Firestore会使用本地缓存，但如果在线时的读取请求不符合安全规则，数据不会被缓存。确认你的安全规则允许读取myCol2集合：

   match /myCol1/{doc1}/myCol2/{doc2} {
     allow read: if true; // 根据实际需求调整权限
   }
   

调试方法 #

• 检查快照来源
  在onSnapshot回调中打印快照元数据，确认是否来自缓存，以及缓存中是否有数据：

  .onSnapshot((snapshot) => {
    console.log('是否来自缓存:', snapshot.metadata.fromCache);
    console.log('文档数量:', snapshot.docs.length);
    // 更新状态逻辑
  });
  

  如果fromCache为true但docs.length为0，说明缓存中确实没有该集合的数据。

• 查看缓存大小
  在线加载数据后，调用getCacheSize()确认缓存是否写入：

  firestore().getCacheSize().then(size => console.log('缓存大小(字节):', size));
  

  如果缓存大小没有明显增长，说明数据未被缓存。

• 模拟离线环境
  使用Firebase模拟器测试离线模式：

  1. 启动Firestore模拟器
  2. 在线加载数据后，切换模拟器的离线模式
  3. 验证查询是否返回缓存数据

  也可以直接关闭设备网络，在真实环境中测试。

内容的提问来源于stack exchange，提问作者Matthieu Le Cauchois