Flutter用ListView.builder读取Firestore数组报Widget非空错误如何解决？

该错误的核心原因是ListView.builder的itemBuilder参数要求每次调用必须返回非空的Widget类型值，你的代码第56行附近的逻辑存在未覆盖的分支，会出现无返回值或返回null的情况，不符合Dart空安全规范。

常见触发场景 #

• 仅给条件判断的满足分支配置了返回Widget，缺省else分支的返回逻辑，比如只写了if (snapshot.hasData) { return ... }，未处理snapshot无数据的场景
• 处理数组索引时的异常判断分支没有返回Widget
• 未对Firestore返回的数组做非空兜底，数组为null时直接进入渲染逻辑

修复方案 #

所有itemBuilder的逻辑分支都必须配置返回值，无内容可渲染时可以返回SizedBox.shrink()等占位空组件，参考代码示例：

// 先处理Firestore数据的非空判断
final List itemArray = snapshot.data?.get('目标数组字段') ?? [];

return ListView.builder(
  itemCount: itemArray.length,
  itemBuilder: (context, index) {
    // 所有分支都要有返回值
    final currentItem = itemArray[index];
    if (currentItem == null) {
      return const SizedBox.shrink();
    }
    return ListTile(
      title: Text(currentItem.toString()),
    );
  }
);

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