Flutter+Firestore出现[]方法调用报错，是否与空安全有关及如何修复

该报错完全由Dart空安全特性触发，问题根源如下：

• Firestore的DocumentSnapshot.data()方法返回类型为Map<String, dynamic>?，属于可空类型，Dart空安全规则禁止直接对可空对象调用[]操作符
• 即使data()返回非空Map，'title'字段也可能不存在，返回值依旧为可空类型，不符合Text组件要求传入非空String的参数规则

方案1：快速兜底修复（最稳妥） #

直接添加空安全调用符，同时设置字段为空时的默认展示值，不会出现运行时崩溃：

if (snapshot.hasData == true) {
  return ListView(
    children: snapshot.data!.docs.map((DocumentSnapshot document) {
        return ListTile(
          // ?表示空时终止调用，??后面设置空值时的默认展示内容
          title: Text(document.data()?['title'] ?? '无标题'),
        );
    }).toList(),
  );
}

方案2：强类型断言写法 #

如果你可以保证所有查询到的文档都一定存在非空的title字段，可以做类型强制转换：

if (snapshot.hasData == true) {
  return ListView(
    children: snapshot.data!.docs.map((DocumentSnapshot document) {
        // 强制将data转换为非空Map类型
        final Map<String, dynamic> data = document.data() as Map<String, dynamic>;
        return ListTile(
          title: Text(data['title'] as String),
        );
    }).toList(),
  );
}

方案3：实体类转换（长期项目推荐） #

将Firestore文档和自定义实体类绑定，避免硬编码字段名，提升代码可维护性：

1. 首先定义业务实体类

class Post {
  final String title;
  Post({required this.title});

  static Post fromDocument(DocumentSnapshot doc) {
    final data = doc.data() as Map<String, dynamic>;
    return Post(
      title: data['title'] ?? '无标题',
    );
  }
}

2. 业务代码中直接调用转换方法

if (snapshot.hasData == true) {
  return ListView(
    children: snapshot.data!.docs.map((DocumentSnapshot document) {
        final post = Post.fromDocument(document);
        return ListTile(
          title: Text(post.title),
        );
    }).toList(),
  );
}

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