最新版Flutter从Firestore快照获取数据映射到Todo模型报错如何解决？

API 探路者

2026-10-5

问题原因

核心是cloud_firestore插件的版本兼容性问题：你参考的旧教程使用的是2.0.0之前版本的cloud_firestore，该版本中DocumentSnapshot.data()方法的返回值为Map<String, dynamic>类型，可以直接用下标[]读取字段。但新版cloud_firestore适配了Flutter空安全特性后，data()的返回类型调整为Object?，直接调用[]会触发编译报错——因为Object类型没有定义下标运算符。
另外旧写法没有做类型校验和空值处理，运行时如果Firestore中对应字段为空、或者字段类型和预期不符，会直接触发运行时崩溃。

修正后代码

基础可用版本（确保编译通过）

List<Todo> todoFromFirestore(QuerySnapshot snapshot) {
  return snapshot.docs.map((doc) {
    // 先将data()返回值显式转换为Map类型
    final data = doc.data() as Map<String, dynamic>;
    return Todo(
      isComplet: data["isComplet"] as bool,
      title: data["title"] as String,
      uid: doc.id,
    );
  }).toList();
}

鲁棒性优化版本（处理空值避免异常）

如果要兼容字段缺失、空值的场景，推荐加默认值兜底：

List<Todo> todoFromFirestore(QuerySnapshot snapshot) {
  return snapshot.docs.map((doc) {
    final data = doc.data() as Map<String, dynamic>?;
    return Todo(
      // 字段为空/类型不匹配时用默认值兜底
      isComplet: data?["isComplet"] as bool? ?? false,
      title: data?["title"] as String? ?? "",
      uid: doc.id,
    );
  }).toList();
}

后续规避方案