Flutter异步函数返回值问题：如何从含await的async函数返回字符串

首先，你的代码存在两个核心问题：

1. 混合使用await和.then()导致异步流程混乱：在getUserDetailsFromServer().then(...)的回调函数中使用了await，但没有给回调标记async，这会直接引发语法错误，进而影响后续异步操作的正常执行。
2. 错误的返回值方式：async函数本身会自动将返回值包装为Future，不需要手动返回Future.delayed，这种写法会导致类型不匹配，触发返回值非空校验错误。

修正后的代码 #

Future<String> getNumberOfShiftsText() async {
  int weekShiftCount = 0;
  List<DateTime> shiftTimes = [];

  // 用await替代.then()，让异步代码逻辑更清晰
  await getUserDetailsFromServer();
  await getAppointmentsFromServer(cid, isEmployer, rolesList);

  // 获取本地存储的预约列表
  List<HiveAppointment> appointmentList = appointmentBox.values.toList();
  final sevenDaysLater = DateTime.now().add(const Duration(days: 7));
  
  // 遍历统计符合条件的排班
  for (var appointment in appointmentList) {
    if (appointment.startTime.isBefore(sevenDaysLater)) {
      weekShiftCount += 1;
      shiftTimes.add(appointment.startTime);
    }
  }

  // 直接返回字符串，async函数会自动包装为Future<String>
  return '$weekShiftCount shift(s) assigned to you in the next 7 days';
}

关键修改点说明 #

• 统一用await处理异步操作：放弃.then()链式调用，改用await让异步代码写法接近同步逻辑，彻底避免回调嵌套带来的语法错误和逻辑混乱。
• 移除多余的Future.delayed：async函数的返回值会被Dart自动包装为对应的Future类型，直接返回字符串即可满足Future<String>的返回要求。
• 优化循环与计算逻辑：把for循环改为更简洁的for-in遍历，同时将DateTime.now().add(...)抽成变量，避免重复计算提升性能。
• 修复回调异步标记缺失问题：原代码中.then()的回调未标记async，导致内部await无法生效，改用await后彻底解决了这个问题。

错误提示的本质原因 #

你看到的A non-null value must be returned since the return type 'String' doesn't allow null错误，本质是原代码的异步流程存在异常隐患，可能导致函数无法正确返回有效值。修正后的代码确保只要异步操作不抛出异常，就会返回一个合法的非空字符串。

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