Flutter中StreamBuilder读取Firestore数据报错：Null不是String的子类型

错误原因分析 #

报错核心是Firestore返回的字段存在null值，但User类构造函数要求必填非空类型（如String name），直接赋值null触发类型不匹配。常见触发场景：

• Firestore文档缺失name/id等必填字段
• 保存数据时未正确写入所有字段
• fromJson方法未处理字段为null的情况

分步解决方案 #

1. 修复User.fromJson的空安全处理 #

修改User类的fromJson方法，为可能为null的字段添加默认值或null判断：

static User fromJson(Map<String, dynamic> json) => User(
      id: json['id'] ?? '', // 若id字段为null，用空字符串兜底
      name: json['name'] ?? '匿名用户', // 若name缺失，使用默认名称
      age: json['age'] ?? 0, // 若age为null，默认设为0
      // 处理birthday为null的情况，默认返回当前时间
      birthday: (json['birthday'] as Timestamp?)?.toDate() ?? DateTime.now(),
    );

2. 检查Firestore文档数据 #

登录Firebase控制台，查看users集合下的文档，确保每个文档都包含：

• name：字符串类型，无null值
• age：数字类型
• birthday：Timestamp类型（而非字符串或其他格式）

3. 修正保存数据时的ID赋值逻辑 #

如果MilkeForm中保存数据时未将Firestore文档ID赋值给User的id字段，会导致文档缺失id字段，进而读取时json['id']为null。修改保存逻辑示例：

// MilkeForm中的保存代码示例
final user = User(
  name: nameController.text.trim(),
  age: int.parse(ageController.text),
  birthday: selectedDate,
);
// 创建文档引用并获取自动生成的ID
final docRef = FirebaseFirestore.instance.collection('users').doc();
// 将文档ID赋值给user的id属性
user.id = docRef.id;
// 保存到Firestore
await docRef.set(user.toJson());

4. 修正UI显示的语法错误 #

buildUser方法中Text('$user.age')会错误显示为Instance of 'User'.age，改为：

Widget buildUser(User user) => ListTile(
      leading: CircleAvatar(child: Text('${user.age}')), // 用${}正确获取age值
      title: Text(user.name),
      subtitle: Text(user.birthday.toIso8601String()),
    );

调试验证 #

修改代码后重新运行，若仍报错：

• 查看控制台错误详情，定位具体为null的字段
• 在fromJson方法中添加打印语句，输出返回的json内容：

static User fromJson(Map<String, dynamic> json) {
  print('Firestore返回数据：$json'); // 打印调试
  return User(
    id: json['id'] ?? '',
    name: json['name'] ?? '匿名用户',
    age: json['age'] ?? 0,
    birthday: (json['birthday'] as Timestamp?)?.toDate() ?? DateTime.now(),
  );
}

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