Flutter首次谷歌登录报Bad state: DocumentSnapshotPlatform无对应字段错误

• 核心错误原因是直接用ds["lastMessage"]的方式读取Firestore文档字段：如果对应文档不存在lastMessage字段，会直接抛出Bad state: field does not exist within the DocumentSnapshotPlatform错误，不会返回null。
• 仅首次登录触发的诱因：
  1. 新用户首次登录时，还没有产生过任何聊天记录，要么拉取到的聊天室文档是刚初始化的、还没写入lastMessage字段；要么SharedPreferenceHelper().getUserName()还没拿到登录后写入的用户名，查询条件异常拉取到了不符合预期的无对应字段的文档。
  2. 登出后重登不会触发的原因：此时用户名已成功写入本地存储，查询条件正确，且聊天室文档已完成lastMessage字段写入，读取时不会出现字段缺失问题。

1. 修复字段读取逻辑，增加空安全处理 #

不要直接用[]取字段，先把DocumentSnapshot转为Map再读取，不存在的字段会返回null不会抛异常：

Widget chatRoomsList() {
  return StreamBuilder<dynamic>(
    stream: chatRoomsStream,
    builder: (context, snapshot) {
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Center(child: CircularProgressIndicator());
      }
      if (!snapshot.hasData || snapshot.data.docs.isEmpty) {
        // 新用户无聊天记录时展示空状态
        return const Center(child: Text("暂无聊天记录"));
      }
      return ListView.builder(
        itemCount: snapshot.data.docs.length,
        shrinkWrap: true,
        itemBuilder: (context, index) {
          DocumentSnapshot ds = snapshot.data.docs[index];
          Map<String, dynamic> docData = ds.data() as Map<String, dynamic>? ?? {};
          String lastMessage = docData["lastMessage"] ?? "";
          return ChatRoomListTile(lastMessage, ds.id, myUserName);
        });
    },
  );
}

2. 修复Stream初始化时序问题 #

确保getChatRooms()的调用时机在谷歌登录成功、用户名已经写入本地存储之后，不要提前在页面initState中调用，避免查询时拿到空的用户名，拉取到错误的文档。

3. 可选：优化Firestore查询逻辑 #

把用户名作为参数传入getChatRooms方法，而不是在方法内部读取本地存储，确保传入的用户名一定是有效值：

// database.dart中修改getChatRooms定义
Future<Stream<QuerySnapshot>> getChatRooms(String myUsername) async {
  return FirebaseFirestore.instance
      .collection("chatrooms")
      .where("users", arrayContains: myUsername)
      .snapshots();
}

// 调用时传入已经拿到的有效用户名
getChatRooms() async {
  chatRoomsStream = await DatabaseMethods().getChatRooms(myUserName);
  setState(() {});
}

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