Flutter Firestore DocumentSnapshot与Map<String,dynamic>类型不匹配报错问询

cloud_firestore 2.0及以上版本引入了泛型类型安全机制，未明确指定类型的CollectionReference、DocumentReference调用data()方法返回值默认为Object?类型，不会自动推断为Map<String, dynamic>，所以两种写法会分别触发两端的类型校验报错。

这里提供两种可落地的方案，选一种即可：

方案1：全局指定集合泛型（推荐，类型更安全） #

修改自定义扩展方法，给所有文档、集合引用明确指定Map<String, dynamic>泛型，让类型系统自动匹配：

// 修改FirestoreX扩展
extension FirestoreX on FirebaseFirestore {
  Future<DocumentReference<Map<String, dynamic>>> userDocument() async {
    final userOption = await getIt<IAuthFacade>().getSignedInUser();
    final user = userOption.getOrElse(() => throw NotAuthenticatedError());
    return FirebaseFirestore.instance
        .collection('users')
        .doc<Map<String, dynamic>>(user.id.getOrCrash());
  }
}

// 修改DocumentReferenceX扩展，约束作用在带泛型的文档引用上
extension DocumentReferenceX on DocumentReference<Map<String, dynamic>> {
  CollectionReference<Map<String, dynamic>> get noteCollection => collection<Map<String, dynamic>>('notes');
}

修改完成后，noteCollection.snapshots()返回的快照内的文档自动为QueryDocumentSnapshot<Map<String, dynamic>>类型，和你第二版的fromFirestore参数完全匹配，两个报错都会消失。

方案2：fromFirestore内部做类型转换（兼容性更强） #

如果不想修改多处扩展代码，可以直接调整fromFirestore的参数类型，内部做显式类型转换，兼容所有文档快照类型：

factory NoteDto.fromFirestore(DocumentSnapshot<Object?> doc) {
  // 显式转换为序列化需要的Map类型
  final json = doc.data() as Map<String, dynamic>;
  return NoteDto.fromJson(json).copyWith(id: doc.id);
}

这种写法无需修改其他业务代码，两种场景的类型报错都会直接解决，适合快速修复场景，只要确保Firestore中存储的notes文档结构确实为标准JSON格式即可。

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