使用StreamBuilder从Firestore获取数据时遭遇NoSuchMethodError错误

错误原因 #

你遇到的NoSuchMethodError是因为Firestore SDK的API更新：QuerySnapshot对象的documents属性已被重命名为docs，旧版本代码调用snapshot.data.documents会找不到对应方法。此外，原代码未处理StreamBuilder的异步状态（比如数据未加载完成、加载出错的情况），直接访问snapshot.data可能引发额外异常。

修复后的完整代码 #

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter/material.dart';

import 'Navigation.dart';

class MyStatefulWidget extends StatefulWidget {
  const MyStatefulWidget({Key? key}) : super(key: key);

  @override
  State<MyStatefulWidget> createState() => Forums();
}

class Forums extends State<MyStatefulWidget> {
  int currentIndex = 0;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        actions: [
          IconButton(
            icon: const Icon(Icons.notifications_none),
            onPressed: () {},
          ),
          IconButton(
            icon: const Icon(Icons.menu_book),
            onPressed: () {},
          )
        ],
        backgroundColor: Colors.greenAccent,
        shape: const RoundedRectangleBorder(
            borderRadius: BorderRadius.only(
                bottomLeft: Radius.circular(1000),
                bottomRight: Radius.circular(2000))),
        bottom: const PreferredSize(
          preferredSize: Size.fromHeight(200),
          child: SizedBox(),
        ),
      ),
      drawer: const NavigationDrawer(),
      body: StreamBuilder<QuerySnapshot>(
        stream: FirebaseFirestore.instance.collection("courses").snapshots(),
        builder: (context, snapshot) {
          // 处理加载中状态
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }

          // 处理错误状态
          if (snapshot.hasError) {
            return Center(child: Text('加载失败: ${snapshot.error}'));
          }

          // 处理无数据状态
          if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
            return const Center(child: Text('暂无课程数据'));
          }

          // 数据就绪，渲染列表
          return ListView.builder(
            itemCount: snapshot.data!.docs.length,
            itemBuilder: (context, index) {
              DocumentSnapshot course = snapshot.data!.docs[index];
              return ListTile(
                leading: Image.network(course['img'] as String),
                title: Text(course['name'] as String),
              );
            },
          );
        },
      ),
      bottomNavigationBar: BottomNavigationBar(
        type: BottomNavigationBarType.fixed,
        backgroundColor: const Color.fromARGB(255, 247, 247, 247),
        selectedItemColor: Colors.green,
        unselectedItemColor: Colors.greenAccent,
        iconSize: 30,
        showSelectedLabels: false,
        showUnselectedLabels: false,
        currentIndex: currentIndex,
        onTap: (index) => setState(() => currentIndex = index),
        items: const [
          BottomNavigationBarItem(
            icon: Icon(Icons.home, color: Colors.greenAccent),
            label: "Home",
          ),
          BottomNavigationBarItem(
            icon: Icon(Icons.group, color: Colors.greenAccent),
            label: "Forums",
          ),
          BottomNavigationBarItem(
            icon: Icon(Icons.school, color: Colors.greenAccent),
            label: "Courses",
          ),
          BottomNavigationBarItem(
              icon: Icon(Icons.person, color: Colors.greenAccent),
              label: "Guide"),
        ],
      ),
    );
  }
}

关键修改点 #

• 将snapshot.data.documents替换为snapshot.data!.docs：适配Firestore SDK的API变更
• 为StreamBuilder指定泛型StreamBuilder<QuerySnapshot>：提升代码类型安全性
• 添加状态判断逻辑：分别处理加载中、加载错误、无数据的场景，避免空指针异常
• 对course['img']和course['name']添加类型转换：避免动态类型警告

内容的提问来源于stack exchange，提问作者RUTAHIGWA EMMANUEL NOEL