Flutter中FutureBuilder失效，snapshot数据为空问题求助

我在Flutter项目中使用FutureBuilder时遇到异常：snapshot始终无数据，但其他场景下FutureBuilder运行正常，且目标API确实能返回正确数据。相关代码如下：

static Future<List<User>> getUser() async {
  var url = '${Constants.BASE_NO_TOKEN_DOMAIN}api?action=user_profile&token=${Constants.USER_TOKEN}';
  final response = await http.get(Uri.parse(url));
  final body = jsonDecode(response.body);
  return body['data'].map<User>(User.fromJson).toList();
}

@override
void initState() {
  super.initState();
  userFuture = getUser();
  getToken();
}

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: Container(
      color: Color.fromRGBO(245, 248, 250, 1),
      padding: EdgeInsets.only(left: 16, top: 25, right: 16),
      child: ListView(
        children: [
          Container(
            decoration: BoxDecoration(
                color: Colors.white,
                borderRadius: BorderRadius.all(Radius.circular(12))),
            padding: EdgeInsets.only(left: 10, right: 10),
            height: 120,
            child: FutureBuilder<List<User>>(
              future: userFuture,
              builder: (context, snapshot) {
                if (snapshot.connectionState == ConnectionState.waiting) {
                  return CircularProgressIndicator();
                } else if (snapshot.hasData) {
                  final user = snapshot.data!;
                  return buildUser(user);
                } else {
                  print(snapshot.data);
                  print(snapshot.error);
                  return Text("No widget to build");
                }
              },
            ) // FutureBuilder
          ),  //Container

排查方向与解决方法 #

1. Token 初始化顺序错误

你在initState中先执行getUser()，再调用getToken()。如果getToken()是异步获取并更新Constants.USER_TOKEN的方法，那么getUser()执行时token还未被正确赋值，导致请求URL中的token为空，API返回的数据结构不符合预期，最终body['data']无法生成有效List。

解决： 确保token获取完成后再发起请求：

@override
void initState() {
  super.initState();
  _initLoad();
}

void _initLoad() async {
  await getToken(); // 等待token初始化完成
  userFuture = getUser();
  setState(() {}); // 触发UI重建，让FutureBuilder绑定新的future
}

2. API返回数据结构不匹配

虽然API能返回数据，但body['data']可能是单个对象而非数组。直接调用map<User>(User.fromJson).toList()会抛出异常，导致Future进入错误状态，snapshot无数据。

解决： 增加数据类型判断，兼容单个对象的情况：

static Future<List<User>> getUser() async {
  var url = '${Constants.BASE_NO_TOKEN_DOMAIN}api?action=user_profile&token=${Constants.USER_TOKEN}';
  final response = await http.get(Uri.parse(url));
  // 打印日志确认数据结构
  print('API响应: ${response.body}');
  final body = jsonDecode(response.body);
  final data = body['data'];
  
  if (data is Map) {
    // 单个用户对象，转为List返回
    return [User.fromJson(data)];
  } else if (data is List) {
    return data.map<User>(User.fromJson).toList();
  } else {
    // 无有效数据时返回空List
    return [];
  }
}

3. 错误状态处理遗漏

当前的builder未明确处理snapshot.hasError的情况，导致异常发生时无法直观看到问题。

解决： 补充错误分支处理：

builder: (context, snapshot) {
  if (snapshot.connectionState == ConnectionState.waiting) {
    return CircularProgressIndicator();
  } else if (snapshot.hasError) {
    print('加载错误: ${snapshot.error}');
    return Text('加载失败：${snapshot.error.toString()}');
  } else if (snapshot.hasData && snapshot.data!.isNotEmpty) {
    final user = snapshot.data!;
    return buildUser(user);
  } else {
    return Text("暂无用户数据");
  }
}

4. 确认Future变量定义

确保userFuture是类的成员变量，避免在build方法中直接创建Future（会导致每次重建发起新请求）：

late Future<List<User>> userFuture;

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