Flutter监听Firebase文档异常：首次读取正常更新后提示文档不存在

可能的原因 #

1. 监听期间文档被删除：首次读取时文档存在，但后续修改操作中该文档被意外删除。Firestore对已删除文档的监听会触发not-found错误，而非仅返回exists=false的快照。
2. 重复监听导致冲突：如果initListeners方法被多次调用，会为同一文档添加多个监听，后续数据变更时可能触发未预期的错误。
3. 权限变更：修改数据后，当前用户的Firestore权限发生变化，导致无法访问目标文档，部分场景下权限错误会被映射为not-found异常。

修复方案 #

1. 强化错误处理逻辑：在onError中明确捕获not-found错误，执行对应的清理操作（比如移除本地文档记录、取消监听）。
2. 避免重复监听：维护一个监听订阅的集合，在初始化新监听前取消旧的订阅。
3. 验证文档存在性：在触发监听前，先确认文档是否存在，避免对已删除的文档建立监听。

修改后的代码示例 #

// 维护监听订阅，避免重复监听
final Map<String, StreamSubscription> _documentSubscriptions = {};

void initListeners(List<String> listIds) {
  var db = FirebaseFirestore.instance;
  
  // 先取消不再需要的旧监听
  _documentSubscriptions.keys.where((id) => !listIds.contains(id)).forEach((id) {
    _documentSubscriptions[id]?.cancel();
    _documentSubscriptions.remove(id);
  });
  
  for (var id in listIds) {
    // 跳过已存在的监听
    if (_documentSubscriptions.containsKey(id)) continue;
    
    final subscription = db.collection('documents').doc(id).snapshots().listen((event) {
      if (event.exists) {
        final document = Document.fromJson(event.data() as Map<String, dynamic>, id);
        if(isDocumentAvailable(id)) {
          updateDocument(document);
        } else{
          addDocument(document);
        }
      } else {
        print("Document $id does not exist, removing listener");
        _documentSubscriptions[id]?.cancel();
        _documentSubscriptions.remove(id);
        // 可选：从本地移除该文档记录
        removeDocument(id);
      }
    }, onError: (error) {
      print('Error loading document $id: $error');
      // 处理not-found错误
      if (error.toString().contains('cloud_firestore/not-found')) {
        _documentSubscriptions[id]?.cancel();
        _documentSubscriptions.remove(id);
        removeDocument(id);
      }
    });
    
    _documentSubscriptions[id] = subscription;
  }
}

// 记得在页面销毁时取消所有监听
void disposeListeners() {
  _documentSubscriptions.values.forEach((sub) => sub.cancel());
  _documentSubscriptions.clear();
}

额外检查项 #

• 登录Firebase控制台，确认listIds中的所有文档ID对应的文档在修改后仍然存在。
• 检查Firestore安全规则，确保当前用户在数据修改后仍有目标文档的读取权限。

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