如何解决Flutter中DocumentSnapshotPlatform不存在字段的Bad state报错

• 你当前只判断了snapshot.data != null，但未判断文档是否真实存在：当Firestore返回的DocumentSnapshot指向不存在的文档时，snapshot.data不会为空，但exists属性为false，此时直接读取字段就会触发该报错。
• 可空变量userMap未做前置判空：userMap是你自己维护的状态变量，如果在userMap完成初始化赋值前StreamBuilder就开始构建，会导致你监听的文档ID是无效值，请求到不存在的文档。
• 字段读取方式不安全：直接通过下标读取DocumentSnapshot的字段，没有做字段存在性校验。

1. 替换AppBar实现代码 #

补充加载状态、错误状态、文档存在性、字段存在性的多重校验，同时在userMap未初始化完成前不发起无效的Firestore监听：

appBar: AppBar(
  title: userMap == null 
    ? const Text('加载中...')
    : StreamBuilder<DocumentSnapshot>(
        stream: _firestore.collection('users').doc(userMap!['uid']).snapshots(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Text('状态加载中...');
          }
          if (snapshot.hasError) {
            return const Text('状态加载失败');
          }
          if (!snapshot.hasData || !snapshot.data!.exists) {
            return Column(
              children: [
                Text(userMap!['name']),
                const Text('离线', style: TextStyle(fontSize: 14),)
              ],
            );
          }
          // 先将快照转为Map再读取字段
          Map<String, dynamic> userDoc = snapshot.data!.data() as Map<String, dynamic>;
          return Container(
            child: Column(
              children: [
                Text(userMap!['name']),
                Text(
                  // 字段不存在时返回默认值，避免报错
                  userDoc.containsKey('status') ? userDoc['status'] : '离线',
                  style: const TextStyle(fontSize: 14),
                )
              ],
            ),
          );
        }
    ),
  backgroundColor: Colors.white,
  leading: IconButton(
    icon: const Icon(Icons.arrow_back_rounded, color: Colors.black,),
    onPressed: () {
      Navigator.of(context).pushReplacement(MaterialPageRoute(builder: (_) => const chatpage()));
    },
  ),
),

2. 额外校验点 #

• 确保你给userMap赋值的逻辑完成后再调用setState触发页面重绘，避免StreamBuilder监听空的用户ID。
• 务必确认所有操作status字段的逻辑中，字段名拼写完全一致，你初始化用户时的状态值写的是Unavalible（正确拼写为Unavailable），如果是字段名拼写错误也会直接触发该报错。

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