Dart/Flutter async函数返回_Future实例 无法获取字符串返回值

问题原因 #

所有被async关键字标记的函数，Dart会自动将其返回值包装为Future对象，无论你在函数内部return的是什么类型的值，直接同步调用、不等待异步任务完成的话，拿到的永远是Future实例，不可能拿到实际的结果值。

正确实现步骤 #

1. 补全异步函数的类型声明 #

不要省略async函数的返回类型，明确标记返回值为Future<String>，同时建议增加请求状态校验，避免请求失败时拿到不符合预期的返回内容：

Map dataLoginEmployee = {
  'email': employee.getEmail(),
  'password': employee.getPassword(),
};

String bodyLoginEmployee = json.encode(dataLoginEmployee);

Future<String> postDataLoginEmployee() async {
  final response = await http.post(
    Uri.parse(url),
    headers: {"Content-Type": "application/json"},
    body: bodyLoginEmployee,
  );
  if (response.statusCode == 200) {
    return response.body;
  } else {
    throw Exception('登录请求失败，状态码：${response.statusCode}');
  }
}

2. 调用时必须使用await等待结果 #

调用postDataLoginEmployee的外部函数必须标记为async，且调用时必须加await关键字等待异步任务执行完成，才能拿到实际的字符串类型返回值：

// 执行登录逻辑的函数必须加async
void handleLoginAction() async {
  // 必须加await等待异步返回
  String responseBody = await postDataLoginEmployee();
  // 此处的responseBody就是你预期的response.body字符串，可直接使用
  print(responseBody);
}

3. Widget构建场景下的异步调用方案 #

如果需要在Flutter的Widget build方法中获取异步结果渲染UI，不要直接在build里加await，使用FutureBuilder组件处理异步状态即可：

@override
Widget build(BuildContext context) {
  return FutureBuilder<String>(
    future: postDataLoginEmployee(),
    builder: (context, snapshot) {
      // 异步请求未完成时显示加载态
      if (snapshot.connectionState == ConnectionState.waiting) {
        return const Center(child: CircularProgressIndicator());
      }
      // 请求出错时显示错误信息
      if (snapshot.hasError) {
        return Center(child: Text('请求异常：${snapshot.error}'));
      }
      // 拿到实际字符串结果后渲染内容
      String loginResult = snapshot.data!;
      return Text(loginResult);
    },
  );
}

常见错误避坑 #

• 不要不加await直接同步调用async函数，这种写法本身就不符合Dart的类型规则，拿到的永远是Future实例
• 不要尝试用普通getter/setter接收异步结果，普通getter无法等待异步任务完成，本质还是返回Future对象
• 不要将async函数的返回类型声明为void，会导致外部无法监听异步任务的执行状态，也无法拿到返回结果

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