Flutter连接Firebase Firestore时doc.data()取值报[]运算符未定义错误

核心结论 #

这个报错和Android Studio本身无关，根本原因是cloud_firestore插件的版本迭代带来了类型定义变更。
跟练的教程录制时用的是旧版插件，当时DocumentSnapshot.data()的返回类型直接定义为Map<String, dynamic>，可以直接用[]操作符读取字段；但新版插件把这个方法的返回基础类型改成了通用的Object，没有做类型指定的情况下，Object本身不支持[]键值操作，因此触发编译报错。

具体修改方法 #

1. 调整快照解析的逻辑，对doc.data()的返回值做显式强转，明确转为Map<String, dynamic>类型后再提取字段，修改后的代码如下：

List<Brew> _brewListFromSnapshot(QuerySnapshot snapshot) {
  return snapshot.docs.map((doc) {
    // 先把Object类型的返回值强转为Map结构
    final data = doc.data() as Map<String, dynamic>;
    return Brew(
      name: data['name'] ?? '',
      strength: data['strength'] ?? 0,
      sugars: data['sugars'] ?? '0',
    );
  }).toList();
}

2. 建议同步调整Brew类的构造函数，适配Flutter当前的空安全规范，避免后续出现参数可空的编译警告：

class Brew {
  final String name;
  final String sugars;
  final int strength;

  Brew({
    required this.name,
    required this.sugars,
    required this.strength,
  });
}

为什么教程里的原写法不报错 #

教程录制时使用的是0.14版本及更早的cloud_firestore，该版本直接给doc.data()绑定了Map<String, dynamic>的返回类型，不需要手动强转就能直接读字段。在跟着教程配置依赖时，pub会自动拉取匹配当前Flutter环境的最新插件版本，这种版本差带来的写法不兼容，是跟练老Flutter教程时最常见的问题。

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