Flutter访问Firestore集合文档字段报错的正确实现方法

你触发运行报错的核心原因是：在 cloud_firestore 2.0.0 及以上版本中，DocumentSnapshot 的 data 是返回 Object? 类型的 getter，不是可直接通过下标访问的Map类型，直接写 snapshot.data["字段名"] 必然报类型错误。
除此之外你的代码里还有两个隐藏问题：

• Firestore 存储的时间字段默认返回 Timestamp 类型，直接传给 DateFormat 会触发类型不匹配错误
• ListView.builder 未设置 itemCount 参数，会导致列表无限循环构建

方式1：转Map后访问（最常用） #

调用文档快照的 data() 方法，将返回值显式转换为 Map<String, dynamic> 类型，之后即可通过下标正常访问字段：

// 先取出当前位置的文档快照，转成字段Map
final docSnap = _chats[index];
final chatData = docSnap.data() as Map<String, dynamic>;
// 访问普通字段
bool isMe = chatData["senderId"] == uid;
String message = chatData["message"];
// 时间字段需要先把Timestamp转成DateTime
DateTime chatTime = (chatData["dateTime"] as Timestamp).toDate();

方式2：调用get方法直接取字段 #

不需要转整个Map，直接调用快照的 get("字段名") 方法获取对应字段值，写法更简洁：

final docSnap = _chats[index];
bool isMe = docSnap.get("senderId") == uid;
String message = docSnap.get("message");
DateTime chatTime = (docSnap.get("dateTime") as Timestamp).toDate();

Widget _showChats2() {
  // 必须加itemCount，避免无限构建
  return ListView.builder(
    itemCount: _chats.length,
    reverse: true, // 聊天列表建议加reverse，最新消息默认在底部
    itemBuilder: (BuildContext context, int index) {
      final docSnap = _chats[index];
      final chatData = docSnap.data() as Map<String, dynamic>;
      bool isMe = chatData["senderId"] == uid;
      DateTime chatTime = (chatData["dateTime"] as Timestamp).toDate();
      
      return Align(
        alignment: isMe ? Alignment.centerRight : Alignment.centerLeft,
        child: Column(
          children: [
            Align(
              alignment: isMe ? Alignment.centerRight : Alignment.centerLeft,
              child: Card(
                color: isMe ? Colors.purpleAccent : Colors.white,
                elevation: 2,
                child: Padding(
                  padding: const EdgeInsets.all(12),
                  child: Text(
                    chatData["message"],
                    style: TextStyle(
                      color: isMe ? Colors.white : Colors.black
                    ),
                  ),
                ),
              ),
            ),
            Align(
              alignment: isMe ? Alignment.topRight : Alignment.topLeft,
              child: Padding(
                padding: isMe ? const EdgeInsets.only(right: 12) : const EdgeInsets.only(left: 12),
                child: MidText(text: DateFormat('kk:mm').format(chatTime)),
              )
            )
          ],
        ),
      );
    }
  );
}

• 空安全环境下建议对字段值做判空处理，避免Firestore中对应字段不存在时触发类型转换错误
• 如果写入时间时手动存的是DateTime类型（不是Firestore自动生成的Timestamp），可以去掉Timestamp转换逻辑直接使用，但跨平台场景下建议统一存Timestamp避免时区问题
• 聊天列表建议给ListView.builder加reverse: true参数，配合limit做分页加载时逻辑更符合常规聊天交互

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