Flutter开发报错：The method '[]'无法无条件调用，接收者可为null

问题原因 #

element.data()在Firebase Firestore最新版本中返回Map<String, dynamic>?类型（可能为null），同时即便data()不为null，你访问的['image']、['name']、['price']对应的值也可能是空值。如果你的FoodCategoriesModle构造参数要求非空类型，就会触发Dart空安全检查报错。

解决方案 #

以下是几种可行的处理方式，可根据业务需求选择：

方法1：空检查+默认值（推荐，安全可靠） #

如果允许模型参数为空，或希望给缺失字段设置默认值，可采用这种写法：

querySnapshot.docs.forEach((element) {
  final data = element.data() as Map<String, dynamic>?;
  FoodCategoriesModle burgerCategoriesModle = FoodCategoriesModle(
    image: data?['image'] ?? '默认图片地址',
    name: data?['name'] ?? '默认名称',
    price: data?['price'] ?? 0.0,
  );
  newBurgerCategoriesList.add(burgerCategoriesModle);
});

• data?['image']：先判断data是否为null，仅当非空时才访问对应键值
• ??：若左侧值为null，则使用右侧的默认值

方法2：强制断言（仅确定数据必存在时使用） #

如果你能保证Firestore中每个文档都包含image、name、price三个字段，可使用!强制断言非空，但如果数据缺失会导致运行时错误：

querySnapshot.docs.forEach((element) {
  final data = element.data()!; // 断言data不为null
  FoodCategoriesModle burgerCategoriesModle = FoodCategoriesModle(
    image: data['image']!,
    name: data['name']!,
    price: data['price']!,
  );
  newBurgerCategoriesList.add(burgerCategoriesModle);
});

方法3：修改模型类支持空参数 #

如果业务允许这些字段为空，可以调整FoodCategoriesModle的构造参数为可空类型：

class FoodCategoriesModle {
  final String? image;
  final String? name;
  final double? price;

  FoodCategoriesModle({this.image, this.name, this.price});
}

此时原代码可简化为：

querySnapshot.docs.forEach((element) {
  final data = element.data();
  FoodCategoriesModle burgerCategoriesModle = FoodCategoriesModle(
    image: data?['image'],
    name: data?['name'],
    price: data?['price'],
  );
  newBurgerCategoriesList.add(burgerCategoriesModle);
});

方法4：使用Map的get方法设置默认值 #

借助Map的get方法指定默认值，逻辑和方法1类似：

querySnapshot.docs.forEach((element) {
  final data = element.data() ?? {}; // 若data为null，使用空Map兜底
  FoodCategoriesModle burgerCategoriesModle = FoodCategoriesModle(
    image: data.get('image', defaultValue: '默认图片'),
    name: data.get('name', defaultValue: '默认名称'),
    price: data.get('price', defaultValue: 0.0),
  );
  newBurgerCategoriesList.add(burgerCategoriesModle);
});

额外优化建议 #

将burgerCategoriesList = newBurgerCategoriesList;移到forEach循环外部，避免每次循环重复赋值，提升性能：

querySnapshot.docs.forEach((element) {
  // 构造模型并添加到newBurgerCategoriesList的逻辑
});
burgerCategoriesList = newBurgerCategoriesList;

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