Dart调用Firestore时Object类型未定义[]运算符错误如何解决

你遇到的报错是因为cloud_firestore 2.0及以上版本对返回类型做了调整，DocumentSnapshot.data()方法的返回值从之前的Map<String, dynamic>变更为Object?类型，Dart类型校验无法确认Object类型是否支持[]运算符，因此抛出编译错误。

• 方案1：显式类型转换
  对data()的返回值做强制类型转换，确认是Map类型后再读取字段，修改对应代码为：

  (e.data() as Map<String, dynamic>)['name']
  

  如果需要处理异常情况，可使用安全转换加默认值：

  (e.data() as? Map<String, dynamic>)?.['name'] ?? '默认名称'
  

• 方案2：直接使用get()方法读取字段
  DocumentSnapshot本身提供了直接读取指定字段的get()方法，无需先调用data()，可直接修改为：

  e.get('name')
  

• 方案3：使用withConverter做类型绑定（推荐）
  这是Firestore官方推荐的类型安全写法，在查询集合时提前绑定类型转换器，后续调用data()会直接返回目标类型，无需手动转换。示例写法如下：

  // 集合查询时绑定转换器
  final itemCollection = FirebaseFirestore.instance
      .collection('items')
      .withConverter<ItemCard>(
        fromFirestore: (snap, _) => ItemCard.fromJson(snap.data()!),
        toFirestore: (item, _) => item.toJson(),
      );
  // 后续查询拿到的snapshot.data()直接是ItemCard实例
  itemCollection.get().then((snapshot) {
    for (var doc in snapshot.docs) {
      ItemCard item = doc.data();
      print(item.name);
    }
  });
  

升级到2.0+版本的cloud_firestore后，所有直接操作data()返回值的代码都需要补充类型声明，建议全项目统一使用withConverter绑定模型类，可大幅减少类型相关的运行时错误。

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