如何在Flutter中配置Firestore实现文档自动持久化缓存

Firestore 默认get()请求的逻辑是优先尝试从服务器获取最新数据，仅当网络完全不可用时才会降级读取本地缓存，所以网络正常的情况下你始终得到「Not Cached」是预期行为，属于官方默认设计。

1. 是否必须手动设置source参数？ #

不需要全局强制手动设置，根据你的使用场景选择对应方案即可：

1.1 Future 类型get()请求 #

如果你需要实现优先读缓存、避免加载等待，有两种可选方案：

• 方案一：手动指定source: Source.cache，直接读取本地缓存数据，不会发起网络请求，适合对实时性要求不高的场景，缺点是无法自动获取最新数据，需要你额外实现增量同步逻辑。
  对应示例代码：

  var snapshots = await this.db
    .collection('${AppInit.chatsref}')
    .where('members', arrayContains: uid)
    .orderBy('updated_at', descending: true)
    .get(GetOptions(source: Source.cache)); 
  

• 方案二：组合读写逻辑，先读缓存立刻渲染UI，后台异步拉取最新数据更新，既没有加载等待，也能拿到最新数据：
  对应示例代码：

  // 第一步：读缓存立刻渲染，无等待
  var cacheSnap = await this.db
    .collection('${AppInit.chatsref}')
    .where('members', arrayContains: uid)
    .orderBy('updated_at', descending: true)
    .get(GetOptions(source: Source.cache));
  renderChatList(cacheSnap.docs);
  
  // 第二步：后台异步拉取最新数据，更新UI和本地缓存
  this.db
    .collection('${AppInit.chatsref}')
    .where('members', arrayContains: uid)
    .orderBy('updated_at', descending: true)
    .get()
    .then((serverSnap) {
      renderChatList(serverSnap.docs);
    });
  

1.2 Stream 类型snapshot()监听 #

默认的snapshots()监听本身就会第一时间返回本地缓存中的现有数据，后续服务器有数据更新时会自动推送新的快照。你之前遇到stream场景也没有走缓存的问题，一般是因为你没有处理首次返回的缓存快照、等待服务器返回才渲染导致的，不需要额外配置source参数。

2. 聊天类应用最佳实践 #

你无法接受的下图这类加载状态完全可以通过上述方案避免：

聊天类应用的会话列表、消息页建议直接使用Stream监听实现：

• 首次加载直接用Stream返回的缓存数据渲染，完全不会出现加载空白状态，符合你无等待的要求
• 后续新消息、会话更新会自动通过Stream推送，不需要你手动做同步逻辑
• 确认Firestore离线持久化已开启（Flutter端Firestore默认开启，未手动关闭则无需额外配置）

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