Flutter中Firestore字段空值判断失效始终显示无数据怎么办

Flutter开发中接入Firebase Firestore，使用DocumentSnapshot做字段判断时出现逻辑异常：

• 预期逻辑：当用户文档中groupId字段不存在或值为空时，页面显示「No data」文本；当groupId字段存在有效内容时，页面显示「has data」文本
• 实际表现：无论groupId字段是否存储有效内容，页面始终显示「no data」
• 运行效果参考：
  

class _TestState extends State<Test> {
  String userUid = FirebaseAuth.instance.currentUser!.uid;

  @override
  Widget build(BuildContext context) {
    return StreamBuilder<DocumentSnapshot<Map<String, dynamic>>>(
    stream: FirebaseFirestore.instance
        .collection("users")
        .doc(userUid)
        .snapshots(),
    builder: (context, snapshot) {
      if (snapshot.data?.data()?.containsValue('groupId') ==null) {
        return const Text("no data");
      } else {
        // 实际运行时始终走入该分支
        return const Text('has data');
      }
    });
    }
}

代码存在3个核心问题：

• 方法调用错误：Map.containsValue()的作用是查找Map中是否存在值等于传入参数的条目，要判断指定字段名（key）是否存在，需要使用Map.containsKey('groupId')
• 状态处理缺失：没有处理StreamBuilder的加载状态、错误状态，初始加载阶段、流报错时snapshot.data为null会直接命中空判断
• 逻辑不严谨：仅判断字段key存在不够，还需要校验groupId字段的实际值是否为非空有效内容，避免字段存在但值为null/空字符串的场景；另外currentUser使用强制非空符，未登录场景会直接触发崩溃

class _TestState extends State<Test> {
  final String? userUid = FirebaseAuth.instance.currentUser?.uid;

  @override
  Widget build(BuildContext context) {
    // 未登录场景兜底
    if (userUid == null) {
      return const Text("no data");
    }
    return StreamBuilder<DocumentSnapshot<Map<String, dynamic>>>(
      stream: FirebaseFirestore.instance
          .collection("users")
          .doc(userUid)
          .snapshots(),
      builder: (context, snapshot) {
        // 处理加载中、错误状态
        if (snapshot.connectionState == ConnectionState.waiting ||
            snapshot.hasError) {
          return const Text("no data");
        }
        // 判断文档是否存在
        final docData = snapshot.data?.data();
        if (docData == null || !docData.containsKey('groupId')) {
          return const Text("no data");
        }
        // 判断groupId字段值是否为有效内容
        final groupId = docData['groupId'];
        if (groupId == null || groupId.toString().trim().isEmpty) {
          return const Text("no data");
        }
        // 所有校验通过，显示有数据
        return const Text('has data');
      },
    );
  }
}

内容的提问来源于stack exchange，提问作者It'sPhil