使用FutureBuilder返回ListView时遇类型错误：ListView?非Widget

错误原因 #

snapshot.data是可空类型（ListView?），而FutureBuilder的builder闭包要求返回非空的Widget，类型不匹配导致报错。另外你原代码里return snapshot.data还缺少分号，也是需要修正的小问题。

修复方案 #

因为已经通过snapshot.hasData判断数据存在，此时可以用空断言（!）明确告诉编译器snapshot.data非空，或者用空合并运算符兜底。以下是两种可行的修改方式：

方式1：空断言（推荐，因为hasData已确保数据存在）

FutureBuilder<ListView>(
  future: getWidgets(context, this.residents),
  builder: ((context, snapshot) {
    if (snapshot.hasData) {
      return snapshot.data!; // 添加!断言非空，补上分号
    } else {
      return const ListView();
    }
  }),
)

方式2：空合并运算符

FutureBuilder<ListView>(
  future: getWidgets(context, this.residents),
  builder: ((context, snapshot) {
    return snapshot.data ?? const ListView();
  }),
)

优化建议 #

可以补充加载中和错误状态的处理，提升用户体验：

FutureBuilder<ListView>(
  future: getWidgets(context, this.residents),
  builder: ((context, snapshot) {
    if (snapshot.hasData) {
      return snapshot.data!;
    } else if (snapshot.hasError) {
      return const Center(child: Text('加载失败，请重试'));
    } else {
      // 加载中用进度指示器替代空ListView
      return const Center(child: CircularProgressIndicator());
    }
  }),
)

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