如何在Flutter Firestore中仅监听变更的文档？

默认情况下，Firestore的snapshots()方法返回的是整个集合的完整快照，不管是首次加载还是后续变更。要只获取变更的文档，你需要利用QuerySnapshot提供的docChanges属性，它记录了当前快照与上一次快照之间的差异。

实现步骤 #

1. 在监听回调中，遍历result.docChanges数组，每个元素代表一个文档的变更记录
2. 通过DocumentChange.type判断变更类型：added（新增）、modified（修改）、removed（删除）
3. 通过DocumentChange.doc获取对应的变更文档快照

示例代码 #

firestoreInstance
    .collection('Countries')
    .snapshots()
    .listen((result) {
  // 遍历所有变更记录
  for (final change in result.docChanges) {
    final doc = change.doc;
    switch (change.type) {
      case DocumentChangeType.added:
        print('新增文档: ${doc.id} => ${doc.data()}');
        break;
      case DocumentChangeType.modified:
        print('修改文档: ${doc.id} => ${doc.data()}');
        break;
      case DocumentChangeType.removed:
        print('删除文档: ${doc.id}');
        break;
    }
  }
});

注意事项 #

• 首次监听：第一次触发回调时，集合中所有现有文档都会以DocumentChangeType.added的形式返回，这是Firestore的默认行为，用于初始化本地数据。
• 区分首次加载与后续变更：如果需要忽略首次加载的全量数据，只处理后续的变更，可以自行维护一个初始化标记：

  bool _isInitialized = false;
  
  firestoreInstance
      .collection('Countries')
      .snapshots()
      .listen((result) {
    if (!_isInitialized) {
      _isInitialized = true;
      return; // 跳过首次全量加载
    }
    // 处理后续变更
    for (final change in result.docChanges) {
      // ... 变更处理逻辑
    }
  });
  

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