Flutter Firestore查询文档报错：async函数返回类型需为Future

错误原因 #

在Dart中，所有标记为async的函数，其返回值会被自动包装为Future类型。你的函数声明返回List<User>，但由于使用了async和await处理Firestore的异步查询，实际返回的是Future<List<User>>，类型不匹配导致了报错。

修复方案 #

直接修改函数的返回类型为Future<List<User>>，这是Dart异步编程的强制规则：

Future<List<User>> getDiscoveryUsers(String userId) async {
  Query<Object?> query =
      userCollection.where('finishedOnboarding', isEqualTo: true).limit(10);

  var collection = await query.get();
  var users = collection.docs.map((doc) => User.fromSnapshot(doc)).toList();

  return users;
}

使用说明 #

调用这个函数时，需要在另一个async函数中使用await获取结果，或者通过.then()链式处理：

// 在async函数内调用
List<User> users = await getDiscoveryUsers("your_user_id");

// 或者用链式调用
getDiscoveryUsers("your_user_id").then((users) {
  // 处理用户列表
});

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