Flutter中Firestore StreamBuilder使用.where()时调用docs报null错误

你的代码存在两个核心逻辑漏洞，直接触发空指针异常：

• 初始流为null的判断遗漏
  initState触发的getStream()执行后，第一帧渲染时userstream仍为null，此时StreamBuilder绑定的是空流，对应的snapshot.connectionState为ConnectionState.none，不会命中你写的ConnectionState.waiting判断逻辑，代码会直接执行到categSnapshot.data.docs，而此时snapshot.data本身就是null，直接触发报错。
• Firestore复合索引缺失
  当查询同时使用where+orderBy组合条件时，Firebase Firestore要求必须创建对应复合索引才能执行查询。如果未创建索引，snapshots()返回的流会直接抛出错误，此时snapshot.data会被置为null，而你没有处理流的错误状态，也没有提前判断snapshot.data是否为null，就会触发空指针错误。你看到的短暂显示结果后报错，是因为首次返回了本地缓存数据，后续请求因索引校验失败抛出错误。

1. 补全类型声明与流状态判断 #

首先给流变量补充空安全类型声明，替换原有无类型的Stream userstream;：

Stream<QuerySnapshot>? userstream;

再修改StreamBuilder的逻辑，依次处理错误、等待、空数据状态，替换原有body部分的代码：

body: StreamBuilder<QuerySnapshot>(
  stream: userstream,
  builder: (ctx, categSnapshot) {          
    // 优先处理流错误
    if (categSnapshot.hasError) {
      return Center(child: Text('加载失败，请检查配置'));
    }
    // 处理加载中/无有效数据状态
    if (categSnapshot.connectionState == ConnectionState.waiting || categSnapshot.data == null) {
      return Center(child: CircularProgressIndicator());
    }
    final categDocs = categSnapshot.data!.docs;
    // 后续列表逻辑保持不变
    return ListView.builder(
      physics: BouncingScrollPhysics(),
      itemCount: categDocs.length,
      itemBuilder: (context, index) {
        return Card();
      },
    );
  },
),

2. 补全未登录边界判断 #

修改getStream()方法，避免未登录时直接调用uid触发空指针：

getStream() async {
  var firebaseUser = FirebaseAuth.instance.currentUser;
  // 未登录时绑定空流
  if (firebaseUser == null) {
    setState(() {
      userstream = const Stream.empty();
    });
    return;
  }
  setState(() {
    userstream = categcollection
        .where('userId', isEqualTo: firebaseUser.uid)
        .orderBy('createdAt')
        .snapshots();
  });
}

3. 配置Firestore复合索引 #

如果修改完上述逻辑后，控制台抛出关于索引的错误，按照错误提示的字段组合，在Firebase控制台的Firestore索引页创建对应复合索引即可。单字段排序Firestore会自动创建索引，仅where+orderBy的组合查询需要手动配置。

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