Flutter开发：Firestore能否默认从缓存取文档，仅缓存不同时从服务端获取？

Firestore完全支持你描述的需求，以下是具体的实现思路和Flutter代码示例：

核心思路 #

默认从本地缓存读取文档以节省服务端读取次数，同时后台异步检查服务端数据是否有更新，仅当缓存与服务端数据存在差异时才同步最新数据并更新缓存。

1. 强制从缓存读取数据 #

使用GetOptions(source: Source.cache)指定读取源为本地缓存，这样应用启动时直接加载缓存数据，快速展示给用户，不会消耗Firestore的服务端读取配额。

// 获取单个文档的缓存数据
DocumentSnapshot cacheDoc = await FirebaseFirestore.instance
    .collection('user_private_docs')
    .doc('target_doc_id')
    .get(const GetOptions(source: Source.cache));

// 获取多个文档的缓存数据
QuerySnapshot cacheDocs = await FirebaseFirestore.instance
    .collection('user_private_docs')
    .where('owner_uid', isEqualTo: currentUserUid)
    .get(const GetOptions(source: Source.cache));

2. 后台检查服务端数据差异 #

在展示缓存数据的同时，异步发起服务端读取请求，通过对比文档的更新时间或元数据判断是否存在差异。如果有更新，直接使用服务端数据更新界面，Firestore会自动将最新数据同步到本地缓存。

// 异步检查服务端数据更新
Future<void> checkServerUpdates(String docId) async {
  try {
    DocumentSnapshot serverDoc = await FirebaseFirestore.instance
        .collection('user_private_docs')
        .doc(docId)
        .get(const GetOptions(source: Source.server));
    
    // 对比缓存与服务端的更新时间
    if (cacheDoc.metadata.updateTime != serverDoc.metadata.updateTime) {
      // 数据有更新，刷新界面
      updateAppUI(serverDoc.data());
    }
  } catch (e) {
    // 网络异常等情况，忽略即可，保持缓存数据展示
  }
}

3. 处理缓存不存在的边界情况 #

如果是首次启动或缓存被清除，从缓存读取会抛出异常，此时直接从服务端获取数据，Firestore会自动将数据存入本地缓存，供下次启动使用。

Future<void> loadData(String docId) async {
  try {
    // 优先尝试缓存读取
    DocumentSnapshot cacheDoc = await FirebaseFirestore.instance
        .collection('user_private_docs')
        .doc(docId)
        .get(const GetOptions(source: Source.cache));
    showCachedData(cacheDoc.data());
    // 后台检查更新
    checkServerUpdates(docId);
  } catch (e) {
    // 缓存不存在，从服务端获取
    DocumentSnapshot serverDoc = await FirebaseFirestore.instance
        .collection('user_private_docs')
        .doc(docId)
        .get(const GetOptions(source: Source.server));
    showServerData(serverDoc.data());
  }
}

额外说明 #

• Firestore的本地缓存会自动维护与服务端的同步，无需手动更新缓存，当你从服务端获取到最新数据后，缓存会自动被覆盖。
• 这种方案完全适配你的场景：单设备使用时全程走缓存，不消耗服务端读取次数；仅当另一设备修改数据且当前设备缓存未同步时，才触发一次服务端读取，既节省配额又保证数据最终一致性。

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