Flutter+Firebase Storage如何在异步完成后返回完整Future<List>

问题原因 #

你的两次写法都没有正确等待所有getDownloadURL异步任务执行完成，核心问题如下：

• 第一次使用Future.forEach时，传入的回调没有返回getDownloadURL对应的Future，Future.forEach不会等待URL请求完成就会结束执行，导致后续return的列表还没填充完数据
• 第二次使用map写法的错误更明显，map返回的是普通可迭代对象不是Future，直接await不会有任何等待效果，相当于直接跳过了所有URL请求逻辑就返回了列表

修正方案 #

你可以通过Future.wait批量等待所有URL请求的Future执行完成后再返回完整列表，修正后的_video_list函数代码如下：

Future<List<String>> _video_list() async {
  List<String> video_list = ['!!For Debug!!'];
  firebase_storage.ListResult result = await firebase_storage
      .FirebaseStorage.instance
      .ref()
      .child('test_videos')
      .listAll();
  
  // 收集所有获取下载URL的异步任务
  List<Future<String>> urlFutures = result.items.map((firebase_storage.Reference ref) {
    return ref.getDownloadURL();
  }).toList();
  
  // 等待所有URL请求全部完成
  List<String> finishedUrls = await Future.wait(urlFutures);
  video_list.addAll(finishedUrls);
  
  // 调试打印
  print('-------------------------');
  print(video_list);
  return video_list;
}

补充优化建议 #

你当前的FutureBuilder缺少加载状态、错误状态的处理，直接强转snapshot.data as List很容易出现空指针异常，建议增加状态判断：

builder: (context, snapshot) {
  // 加载中状态
  if (snapshot.connectionState == ConnectionState.waiting) {
    return const Center(child: CircularProgressIndicator());
  }
  // 错误状态
  if (snapshot.hasError) {
    return const Center(child: Text("加载视频列表失败"));
  }
  // 正常业务逻辑
  List vl = snapshot.data as List;
  // 其余原有代码...
}

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