Flutter Firebase查询商品报错Bad state: Snapshot has neither data nor error

• 循环逻辑错误：你在循环中每次都给cart变量重新赋值，循环结束后cart只会保留最后一个pid对应的查询流，完全无法获取全部购物车商品的查询结果。
• 空值风险：你声明的cart是可空类型Stream<QuerySnapshot>?，如果cartitems为空列表，循环不会执行，cart会保持为null，StreamBuilder接收到空流就会抛出“Snapshot既没有数据也没有错误”的StateError。
• 查询方式错误：单个where的isEqualTo只能匹配一个值，循环生成多个独立查询的方式本身不符合Firestore的查询规范，效率极低且无法拿到合并结果。

场景1：购物车商品数不超过10个 #

Firestore提供了whereIn操作符，可以一次性匹配字段值在指定列表内的所有文档，直接替换原有逻辑即可：

Stream<QuerySnapshot>? cart;
if (cartitems.isEmpty) {
  // 购物车为空时返回空流避免空值
  cart = const Stream.empty();
} else {
  cart = FirebaseFirestore.instance
      .collection('products')
      .where('pid', whereIn: cartitems)
      .snapshots();
}

场景2：购物车商品数可能超过10个 #

Firestore的whereIn操作符最多支持单次匹配10个值，超过10个时需要把pid列表拆分为多个10项以内的子列表，分别查询后用StreamZip合并多个流的结果：

import 'package:async/async.dart';
import 'dart:math';

// 拆分列表为指定大小的子列表
List<List<String>> splitList(List<String> list, int chunkSize) {
  List<List<String>> chunks = [];
  for (var i = 0; i < list.length; i += chunkSize) {
    chunks.add(list.sublist(i, min(i + chunkSize, list.length)));
  }
  return chunks;
}

// 生成合并后的商品流
Stream<List<QueryDocumentSnapshot>>? cart;
if (cartitems.isEmpty) {
  cart = Stream.value([]);
} else {
  final chunks = splitList(cartitems, 10);
  // 为每个子列表生成查询流
  List<Stream<QuerySnapshot>> streams = chunks.map((chunk) {
    return FirebaseFirestore.instance
        .collection('products')
        .where('pid', whereIn: chunk)
        .snapshots();
  }).toList();
  // 合并多个流的结果
  cart = StreamZip(streams).map((snapshots) {
    return snapshots.expand((snap) => snap.docs).toList();
  });
}

StreamBuilder兼容处理 #

为了避免类似异常，需要在StreamBuilder中按顺序判断加载状态、错误、数据存在性，不要直接访问snapshot.data：

StreamBuilder(
  stream: cart,
  builder: (context, snapshot) {
    // 加载状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator();
    }
    // 错误处理
    if (snapshot.hasError) {
      return Text('加载失败：${snapshot.error}');
    }
    // 空数据处理
    if (!snapshot.hasData || (snapshot.data as List).isEmpty) {
      return const Text('购物车暂无商品');
    }
    // 正常渲染商品列表
    final productList = snapshot.data as List<QueryDocumentSnapshot>;
    return ListView.builder(
      itemCount: productList.length,
      itemBuilder: (context, index) {
        // 渲染单个商品逻辑
        final product = productList[index].data() as Map<String, dynamic>;
        return Text(product['name']);
      },
    );
  },
)

内容的提问来源于stack exchange，提问作者ali masarra