Flutter开发：snapshot.hasData为何对空响应始终返回true？

数据老陈

2026-10-30

问题成因

FutureBuilder提供的snapshot.hasData、snapshot.data == null两类判断，只会检查快照里有没有非空的返回对象，不会自动帮你校验对象内部承载的业务数据是不是为空。
你碰到的空响应场景下，服务器返回{"data": []}，你的MyItems.fromJson方法会正常走完流程：把空的data数组通过List.from生成一个长度为0的空列表，最终返回一个非空的合法MyItems实例。这个实例本身完全符合hasData的判定规则，所以你不管怎么判断实例是不是null，都没法识别出内部业务数据为空的情况——真正的空数据藏在MyItems.dataa列表里，不是实例本身为空。
顺带提个隐患：当前模型类没做字段缺失兜底，一旦服务器某次响应里没带data字段，json["data"].map(...)会直接因为给null调用map方法抛异常。

正确的空数据判断逻辑

判断节点要下沉到模型实例内部的业务数据层，别只停留在“实例存不存在”的层面：

推荐的判断优先级如下：

先通过snapshot.connectionState区分网络状态，分别处理加载中、请求失败的场景

确认请求成功、拿到非空的MyItems实例后，直接校验实例内部的dataa列表是否为空：

if (snapshot.hasData) {
  final myItems = snapshot.data as MyItems;
  // 这才是判断业务数据是否为空的正确节点
  if (myItems.dataa.isEmpty) {
    // 展示空状态提示
    return EmptyTipWidget();
  }
  // 数据正常时渲染列表
  return ListView.builder(
    itemCount: myItems.dataa.length,
    itemBuilder: (context, index) => ListTile(
      title: Text(myItems.dataa[index].Name),
    ),
  );
}

为了避免dataa为null导致判断报错，给模型类的fromJson方法加一层空值兜底，让dataa永远是非空列表：
```
factory MyItems.fromJson(Map<String, dynamic> json) => MyItems(
  dataa: json["data"] == null 
    ? [] 
    : List<Datumm>.from(json["data"].map((x) => Datumm.fromJson(x))),
);
```
加完兜底后，判断空的时候不需要额外写myItems.dataa == null的校验，直接判isEmpty就够。

现有代码的隐含bug修正

Datumm类的toJson方法存在变量引用错误：当前代码序列化时引用了根本不存在的crbtCode、artistName变量，实际应该对应本类的成员字段，修正后如下：
```
Map<String, dynamic> toJson() => {
  "user_id": userId,
  "Name": Name,
  "MiddelName": MiddelName,
};
```
API请求的超时参数设置错误：当前Duration(seconds: 15000)等价于4个多小时的超时等待，常规网络请求的超时值应该是15秒，也就是Duration(milliseconds: 15000)。

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