Flutter使用StreamBuilder时snapshot.data.documents报空安全错误如何解决？

报错原因 #

• 第一个空安全报错：Dart空安全规则要求不能直接访问可能为null的对象属性，snapshot.data在流返回数据前/请求失败时都可能为null，直接访问documents会触发校验报错。
• 第二个类型报错：你没有为StreamBuilder指定泛型，Dart无法识别snapshot.data的实际类型，默认当做Object类型处理，该类型不存在documents属性，因此触发报错。

修复步骤 #

1. 为StreamBuilder添加泛型声明，明确snapshot.data的类型为QuerySnapshot
   修改前代码：

child: StreamBuilder(
  stream: Firestore.instance
      .collection('tasks')
      .document(uid)
      .collection('mytasks')
      .snapshots(),

修改后代码：

child: StreamBuilder<QuerySnapshot>( // 新增泛型声明
  stream: Firestore.instance
      .collection('tasks')
      .document(uid)
      .collection('mytasks')
      .snapshots(),

2. 补充非空判断逻辑，确保访问属性时snapshot.data一定不为空
   修改builder逻辑如下：

builder: (context, snapshot) {
  if (snapshot.connectionState == ConnectionState.waiting) {
    return Center(
      child: CircularProgressIndicator(),
    );
  }
  // 新增数据非空校验和错误处理
  if (snapshot.hasError || !snapshot.hasData) {
    return Center(child: Text("加载失败或暂无待办数据"));
  }
  // 确认非空后使用!运算符强制拆包，直接访问documents属性
  final docs = snapshot.data!.documents;
  // 此处添加后续的列表渲染逻辑即可

如果你使用的是0.14.0以上版本的cloud_firestore依赖，QuerySnapshot的documents字段已更名为docs，替换为final docs = snapshot.data!.docs;即可解决相关报错。

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