Flutter/Dart null-safety实现：解决StreamBuilder中snapshot.data空引用报错

• 当前使用的Dart 2.12版本默认启用空安全类型系统，分析器会对所有可空类型对象做严格解引用检查，只要无法100%推导出对象非空，就会触发“可取值为null的表达式在解引用前必须完成空检查”的报错。
• 原有代码存在两个硬伤，直接导致分析器无法完成非空推导：
  1. 错误判断逻辑写反：原本应该在发生错误时展示错误提示，代码里写成了if (!snapshot.hasError)（即没有错误时）返回错误文本，分支逻辑完全颠倒。
  2. 类型推导链路断裂：没有给StreamBuilder指定明确的泛型类型，分析器无法识别snapshot.data的具体类型，加上前面颠倒的分支逻辑，就算写了snapshot.data == null的判断，也没法顺着零散的判断推导出else分支里的data一定非空，走到解引用代码时就会触发报错。

• 给StreamBuilder添加明确的泛型声明StreamBuilder<QuerySnapshot>，让分析器直接识别snapshot的完整类型定义
• 按照“加载状态→错误状态→正常数据展示”的顺序重排状态判断分支，让流分析可以顺着分支顺序推导出后续代码里的data非空
• 把取文档列表的逻辑抽成局部变量，避免重复解引用，同时适配新版cloud_firestore的属性命名

修复后的完整代码：

CollectionReference dinners = FirebaseFirestore.instance.collection('DinnerNames');

return Scaffold(
  appBar: AppBar(
    title: const Text('My Dinner Voting App'),
  ),
  body: StreamBuilder<QuerySnapshot>(
    stream: dinners.snapshots(),
    builder: (context, snapshot) {
      // 优先处理加载中状态
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Text('Firestore snapshot is loading..');
      }
      // 处理错误状态
      if (snapshot.hasError) {
        return const Text('Firestore snapshot has error..');
      }
      // 经过前面的状态判断，此处data一定非空，提取文档列表
      final docList = snapshot.data!.docs;
      return ListView.builder(
        itemExtent: 80.0,
        itemCount: docList.length,
        itemBuilder: (context, index) => _buildListItem(context, docList[index]),
      );
    },
  ),
);

补充：新版cloud_firestore插件中，旧版的documents属性已更名为docs，继续使用旧写法会被标记为废弃，建议直接适配新命名。

内容的提问来源于stack exchange，提问作者Davaa Ch