StreamBuilder返回空列表时如何展示指定Widget？Firestore空集合hasData为true问题

Cloud Firestore 的 collection().snapshots() 接口在请求成功时，无论目标集合是否存在、是否有文档，都会返回非空的 QuerySnapshot 对象。你自定义的映射方法 patientsListFromQuerySnapShot 会将无文档的查询结果映射为空的 List<Patient> 数组，而 AsyncSnapshot.hasData 的判断逻辑仅校验 data 字段是否为非空值，空数组不属于 null，因此会始终命中 snapshot.hasData == true 分支。

推荐优先调整 StreamBuilder 内的判断逻辑，无需修改上游流定义，逻辑更直观易维护：

StreamBuilder<List<Patient>>(
  stream: FirebaseApi().getAllPatients,
  builder: (context, snapshot) {
    // 优先处理加载状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }
    // 处理错误状态
    if (snapshot.hasError) {
      return Center(child: Text('加载失败：${snapshot.error.toString()}'));
    }
    // 校验数据是否为空
    final List<Patient> patientList = snapshot.data ?? [];
    if (patientList.isEmpty) {
      return const Center(child: Text('No Patients'));
    }
    // 有有效数据时的业务逻辑
    return Column(
      children: [
        buildSearch(),
        query == ''
            ? buildAllPatients(patientList)
            : filteredPatientsNum(data: patientList).isNotEmpty
                ? buildFilteredPatients(patientList)
                : const Center(child: Text('No Patients Found')),
      ],
    );
  },
)

如果你确实需要让空列表场景命中 snapshot.hasData == false 分支，可以调整流的映射逻辑，空列表时返回 null，注意需要将流的泛型改为可空类型：

Stream<List<Patient>?> get getAllPatients {
  return FirebaseFirestore.instance
      .collection('Patients')
      .snapshots()
      .map((querySnapshot) {
        final patientList = patientsListFromQuerySnapShot(querySnapshot);
        return patientList.isEmpty ? null : patientList;
      });
}

注：该方案将空列表等同于无数据状态，不符合常规业务逻辑的语义表达，更推荐第一种调整判断逻辑的方案。

内容的提问来源于stack exchange，提问作者Njm Jeb