如何解决Flutter中类'Object?'未定义运算符'[]'的报错问题

报错根因 #

空安全版本的cloud_firestore库中，DocumentSnapshot.data()方法的返回类型为Object?，该基类未定义[]下标取值运算符，无法直接读取字段值，你需要先将返回结果显式转换为Firestore实际返回的Map<String, dynamic>字典类型。

解决方案 #

方案1：直接显式类型转换（快速修复） #

将报错行代码修改为如下内容，先做类型转换再读取字段：

(snapshot.data!.data() as Map<String, dynamic>)['status'],

如果需要兼容空值、字段不存在的异常场景，可增加兜底逻辑，修改后的完整builder代码如下：

builder: (context, snapshot){
  if (snapshot.hasData && snapshot.data != null){
    // 先做安全的类型转换
    final Map<String, dynamic>? userDoc = snapshot.data!.data() as Map<String, dynamic>?;
    // 字段为空/不存在时默认显示离线
    final String userStatus = userDoc?['status'] ?? '离线';
    return Container(
      child: Column(
        children: [
          Text(userMap['name']),
          Text(
            userStatus,
            style: const TextStyle(fontSize: 14),
          )
        ],
      ),
    );
  }else{
    return Container();
  }
}

方案2：使用类型化查询（更规范，后续无需重复转换） #

你可以在定义流的时候就通过withConverter指定返回数据类型，后续取值无需再做转换：

stream:  _firestore.collection('users')
    .doc(userMap['uid'])
    // 直接指定返回数据为Map类型
    .withConverter<Map<String, dynamic>>(
      fromFirestore: (snapshot, _) => snapshot.data() ?? <String, dynamic>{},
      toFirestore: (data, _) => data,
    )
    .snapshots(),

配置完成后原报错行可直接正常取值：

snapshot.data!.data()['status'],

内容的提问来源于stack exchange，提问作者Coding-Jutsu