Flutter中fromDocumentSnapshot报Object?无法赋值给String类型错误

使用DocumentSnapshot获取Firebase Firestore文档快照数据时，程序抛出如下类型报错：

The argument type 'Object?' can't be assigned to the parameter type 'String'.

问题复现代码：

class UserModel {
  String groupLeader;

  UserModel({
    required this.groupLeader,
  });

     factory UserModel.fromDocumentSnapshot({required DocumentSnapshot doc}) {
        return UserModel(
          //Problem Here
          groupLeader: doc.data(["groupLeader"]),
        );
      }
}

报错触发位置为工厂构造方法中给groupLeader属性赋值的代码行：doc.data(["groupLeader"])返回的Object?可空类型，无法直接赋值给声明为非空String类型的groupLeader参数。

• 方法调用错误：DocumentSnapshot的data()方法作用是返回文档对应的全量键值对Map，不支持传入数组参数获取指定字段，doc.data(["groupLeader"])属于错误用法，返回值类型不符合预期。
• 类型不匹配：Firestore取字段的返回值默认是可空的Object?/dynamic类型，Dart空安全机制下，不允许将可空、类型不确定的值直接赋值给声明为非空String的属性，因此触发类型检查报错。

根据字段实际是否允许为空，选择对应写法：

• 若确认Firestore中groupLeader字段必然存在、且值始终为字符串类型，直接做显式类型强转即可：

factory UserModel.fromDocumentSnapshot({required DocumentSnapshot doc}) {
  // 先获取文档全量数据并转类型
  final docData = doc.data() as Map<String, dynamic>;
  return UserModel(
    groupLeader: docData["groupLeader"] as String,
  );
}

• 若存在字段缺失、值为null的可能，有两种适配方案：
  1. 将groupLeader声明为可空类型，直接接收可空返回值
  2. 保留非空声明，设置空值兜底默认值
     对应代码示例：

class UserModel {
  // 方案1：声明为可空类型
  String? groupLeader;

  // 方案2：保留非空，后续赋值时兜底
  // String groupLeader;

  UserModel({
    this.groupLeader,
    // required this.groupLeader,
  });

  factory UserModel.fromDocumentSnapshot({required DocumentSnapshot doc}) {
    final docData = doc.data() as Map<String, dynamic>;
    return UserModel(
      // 方案1对应赋值
      groupLeader: docData["groupLeader"] as String?,
      // 方案2对应赋值：groupLeader: (docData["groupLeader"] as String?) ?? "",
    );
  }
}

注意：不要使用doc.data(["字段名"])的写法获取单个字段，该写法是对data()方法的错误使用。

内容的提问来源于stack exchange，提问作者It'sPhil