Flutter Firestore StreamBuilder报错：Null不是String的子类型

错误原因 #

报错type 'Null' is not a subtype of type 'String'是因为你尝试把null值传给了Text组件，而Text要求必须传入String类型。大概率是以下两种情况：

• Firestore中Todos集合的某条文档里，text字段的值为null
• 代码里字段名拼写错误（Firestore字段名区分大小写，比如把text写成了Text）

解决方案 #

1. 检查Firestore数据 #

登录Firebase控制台，查看Todos集合的所有文档，确认每一条的text字段都有非null的字符串值，同时核对字段名是否为小写的text，没有拼写错误。

2. 代码层面添加Null安全处理 #

即使当前数据没问题，也要在代码中做防御性处理，避免后续新增数据时出现同样错误。修改ListView部分的代码：

return ListView(
  children: snapshot.data!.docs.map((DocumentSnapshot document) {
    Map<String, dynamic> data = document.data()! as Map<String, dynamic>;
    
    // 给text字段设置默认值，避免null
    String todoText = data['text'] ?? '未命名任务';
    // 或者更严谨的类型检查
    // String todoText = (data['text'] is String) ? data['text'] : '未命名任务';

    return ListTile(title: Text(todoText));
  }).toList(),
);

3. 进阶：使用模型类序列化数据（可选） #

为了避免字段名拼写错误和类型问题，可以创建一个Todo模型类，将Firestore数据转换成模型对象：

class Todo {
  final String id;
  final String text;
  final bool checked;

  Todo({required this.id, required this.text, required this.checked});

  // 从Firestore文档转换为Todo对象
  factory Todo.fromDocument(DocumentSnapshot doc) {
    Map<String, dynamic> data = doc.data()! as Map<String, dynamic>;
    return Todo(
      id: doc.id,
      text: data['text'] ?? '未命名任务',
      checked: data['checked'] ?? false,
    );
  }
}

然后修改StreamBuilder中的代码：

return ListView(
  children: snapshot.data!.docs.map((DocumentSnapshot document) {
    Todo todo = Todo.fromDocument(document);
    return ListTile(title: Text(todo.text));
  }).toList(),
);

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