Flutter Firebase查询用户文档遇Map类型不匹配错误，求解决方案

问题根源 #

错误核心是两个类型不匹配问题：

• Firestore文档快照的snap.data()返回可空的Map<String, dynamic>?，但User.fromMap方法要求的是不可空的Map<dynamic, dynamic>
• 两种Map的泛型类型不一致，导致无法直接赋值

具体修复步骤 #

1. 更新User类的fromMap工厂方法

修改参数类型为Map<String, dynamic>?，同时兼容null场景（比如文档不存在时返回默认值）：

class User {
  String userID;
  String userName;

  User({required this.userID, required this.userName});

  factory User.fromMap(Map<String, dynamic>? data) {
    return User(
      userName: data?['username'] ?? '',
      userID: data?['userID'] ?? '',
    );
  }
}

2. 保持Database类的Stream方法不变

此时User.fromMap已经可以接收snap.data()返回的类型，原代码无需额外修改：

class Database{
  final FirebaseFirestore _firestore = FirebaseFirestore.instance;

  Stream<User> user(String userID){
    return _firestore.collection('users').doc(userID).snapshots()
        .map((snap) => User.fromMap(snap.data()));
  }
}

可选：增强错误处理（文档不存在场景）

如果需要对用户文档不存在的情况做特殊处理，可以在Stream的map回调中判断快照是否存在：

Stream<User> user(String userID){
  return _firestore.collection('users').doc(userID).snapshots()
      .map((snap) {
        if (!snap.exists) {
          // 可选：抛出异常或返回默认用户对象
          throw Exception("指定用户的文档不存在");
          // 或者 return User(userID: userID, userName: "未知用户");
        }
        return User.fromMap(snap.data());
      });
}

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