Flutter登录报错：Null类型不是Map<String,dynamic>的子类型求助

你遇到的错误是因为DocumentSnapshot.data()可能返回null，直接强制转换为Map<String, dynamic>会触发类型不匹配。通常这种情况发生在Firestore中找不到对应用户的文档时，或者文档数据为空。

修复方案： #

1. 先验证文档存在性：在读取数据前检查文档是否存在，避免读取不存在的文档导致null
2. 安全类型转换：使用as?替代as，配合默认值处理null情况
3. 字段空安全兜底：给User类的每个必填字段设置默认值，防止Firestore字段缺失引发新错误

修改后的fromSnap方法代码：

static User fromSnap(DocumentSnapshot snap) {
  // 先确认文档存在
  if (!snap.exists) {
    throw Exception("用户文档不存在");
  }
  // 安全转换，转换失败时返回空Map
  var snapshot = snap.data() as? Map<String, dynamic> ?? {};

  return User(
    username: snapshot['username'] ?? '',
    uid: snapshot['uid'] ?? '',
    email: snapshot['email'] ?? '',
    photoUrl: snapshot['photoUrl'] ?? '',
    bio: snapshot['bio'] ?? '',
    followers: snapshot['followers'] ?? [],
    following: snapshot['following'] ?? [],
  );
}

额外排查点： #

• 确认登录后获取的用户UID是否正确，检查是否用这个UID去Firestore查询文档
• 验证Firestore中是否存在对应UID的用户文档，确保用户注册时已成功写入数据

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