Firebase Storage文件上传：forEach循环后urlList为空问题排查

核心原因 #

你代码里的forEach回调使用了async，但forEach本身不会等待异步回调执行完成。外部的print(urlList.length())会在所有上传操作开始前就执行，此时urlList还没有被添加任何元素，所以显示为空。

而循环内部的print能看到列表有值，是因为它是在单个文件上传完成后才执行的——这些异步操作都是在外部print执行结束后才陆续完成的。

修正方案 #

方案一：使用普通for循环（串行上传）

普通for循环可以配合await，逐个等待上传操作完成，确保外部代码在所有上传结束后再执行：

Future uploadImage(List<File>? fileList) async {
  List<String> urlList = [];
  if (compressedImageFromDevice != null) {
    for (var file in compressedImageFromDevice!) {
      final ref = FirebaseStorage.instance
          .ref()
          .child("img")
          .child(id)
          .child(time);
      final result = await ref.putFile(file);
      final String mediaUrl = await result.ref.getDownloadURL();
      urlList.add(mediaUrl);
      print(urlList.length());
    }
  }
  print(urlList.length()); // 此时会显示正确的列表长度
}

方案二：使用Future.wait（并行上传，效率更高）

如果想同时上传多个文件，用Future.wait批量等待所有异步操作完成，适合需要提升上传速度的场景：

Future uploadImage(List<File>? fileList) async {
  List<String> urlList = [];
  if (compressedImageFromDevice != null) {
    // 生成所有上传的Future任务
    final uploadFutures = compressedImageFromDevice!.map((file) async {
      final ref = FirebaseStorage.instance
          .ref()
          .child("img")
          .child(id)
          .child(time);
      final result = await ref.putFile(file);
      return await result.ref.getDownloadURL();
    }).toList();
    
    // 等待所有上传完成，直接获取所有URL
    urlList = await Future.wait(uploadFutures);
  }
  print(urlList.length()); // 正确显示上传完成后的列表长度
}

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