Flutter StreamBuilder报Unexpected null value错误求助

错误原因分析 #

• 直接强制解包snapshot.data!，当Stream处于加载状态、无数据或出现异常时，snapshot.data为null，触发空值错误
• FirebaseAuth.instance.currentUser可能为null（比如用户未完成登录流程），直接访问uid会导致空值异常
• 代码中ConnectionState == ConnectionState.waiting;是无效代码，未起到判断加载状态的作用

修复后的代码 #

child: StreamBuilder(
  stream: FirebaseAuth.instance.currentUser == null 
      ? null 
      : FirebaseFirestore.instance
          .collection("Users")
          .doc(FirebaseAuth.instance.currentUser!.uid)
          .collection("Coins")
          .snapshots(),
  builder: (BuildContext context, AsyncSnapshot<QuerySnapshot> snapshot) {
    // 处理加载状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }

    // 处理异常情况
    if (snapshot.hasError) {
      return Center(child: Text("加载出错: ${snapshot.error}"));
    }

    // 处理用户未登录情况
    if (FirebaseAuth.instance.currentUser == null) {
      return const Center(child: Text("请先登录"));
    }

    // 处理无数据情况
    if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
      return const Center(child: Text("暂无持有的币种数据"));
    }

    // 有数据时渲染列表
    return ListView(
      children: snapshot.data!.docs.map((document) {
        return Container(
          padding: const EdgeInsets.symmetric(vertical: 8, horizontal: 16),
          child: Row(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              Text("币种名称: ${document.id}"),
              Text("持有数量: ${document.data()['Amount'] ?? 0}"),
            ],
          ),
        );
      }).toList(),
    );
  },
),

关键修复点说明 #

• 先判断用户是否登录，避免currentUser为null时访问uid
• 依次处理加载状态、异常、无数据等边界情况，避免强制解包空值
• 对document.data()['Amount']添加空值判断，避免字段不存在时触发错误
• 移除无效的ConnectionState比较代码，改为正确的状态判断逻辑

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