Flutter空安全报错：'Null'不是'String'子类型，求解析

问题本质 #

你遇到的_TypeError (type 'Null' is not a subtype of type 'String')，核心原因是Flutter空安全的类型约束：

• 你的User类中，username参数被定义为非空的String类型（未加?），空安全规则禁止将Null赋值给非空类型变量。
• snapshot["username"]返回了Null（要么Firestore文档里没有这个字段，要么字段值本身就是Null），直接赋值给非空的username触发了类型错误。

解决方案 #

根据业务需求选择以下一种方式处理：

1. 允许User字段为空 #

如果业务上username可以不存在，修改User类的字段定义为可空类型：

class User {
  final String? username;
  final String? uid;
  final String? email;
  final String? photoUrl;
  final String? bio;
  final List? followers;
  final List? following;

  User({
    this.username,
    this.uid,
    this.email,
    this.photoUrl,
    this.bio,
    this.followers,
    this.following,
  });
}

2. 给空字段设置默认值 #

如果username必须有值，给可能为Null的字段设置默认值，确保永远传递非空值：

static User fromSnap(DocumentSnapshot snap) {
  var snapshot = snap.data() != null ? 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"] ?? [],
  );
}

3. 校验必填字段，抛出异常 #

如果username是业务必填项，文档里必须存在，提前校验字段是否存在，不存在则抛出异常：

static User fromSnap(DocumentSnapshot snap) {
  var snapshot = snap.data() as Map<String, dynamic>? ?? {};

  // 校验必填字段
  final username = snapshot["username"];
  if (username == null) {
    throw ArgumentError("用户文档缺少必填字段：username");
  }
  final uid = snapshot["uid"];
  if (uid == null) {
    throw ArgumentError("用户文档缺少必填字段：uid");
  }

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

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