Flutter项目中如何获取Firebase Storage多文件的下载URL？

问题根源 #

• 上传操作未等待完成就执行后续逻辑：putFile是异步方法，直接调用而未加await，导致文件还未上传成功就去读取文件夹内容，无法获取到链接。
• 列表初始化位置错误：imageLinks被放在循环内部，每次循环都会重新创建空列表，之前的链接无法保留。
• 未等待Future.wait完成：调用Future.wait但未加await，代码会跳过异步操作继续执行，打印时列表仍为空。
• 无需通过listAll获取链接：每个文件上传时已有对应的StorageReference，直接对单个文件获取下载URL更高效。

修正后的串行上传代码 #

Uuid uuid = const Uuid();
Future<void> selectImages() async {
  String path = uuid.v4();
  List<XFile>? selectedImages = await picker.pickMultiImage();
  if (selectedImages != null) {
    // 简化File列表转换逻辑
    List<File> filePaths = selectedImages.map((xFile) => File(xFile.path)).toList();
    // 将链接列表移到循环外部，保存所有结果
    List<String> imageLinks = [];

    for (int i = 0; i < filePaths.length; i++) {
      var imageStorageRef = storage.child(
          'SentImages/${widget.chatRoomID}/$path/${uuid.v1()}');
      // 等待当前文件上传完成
      await imageStorageRef.putFile(filePaths[i]);
      // 直接获取当前文件的下载URL并添加到列表
      String downloadUrl = await imageStorageRef.getDownloadURL();
      imageLinks.add(downloadUrl);
      print('已获取的链接：$imageLinks');
    }

    // 循环结束后输出所有链接
    print('所有图片下载链接：$imageLinks');
  }
}

优化方案：并行上传（更快） #

如果想同时处理所有上传任务，可使用Future.wait实现并行上传，提升效率：

Uuid uuid = const Uuid();
Future<void> selectImages() async {
  String path = uuid.v4();
  List<XFile>? selectedImages = await picker.pickMultiImage();
  if (selectedImages != null) {
    List<File> filePaths = selectedImages.map((xFile) => File(xFile.path)).toList();
    
    // 创建所有上传+获取URL的任务集合
    List<Future<String>> uploadTasks = filePaths.map((file) async {
      var storageRef = storage.child('SentImages/${widget.chatRoomID}/$path/${uuid.v1()}');
      await storageRef.putFile(file);
      return storageRef.getDownloadURL();
    }).toList();

    // 等待所有任务完成，直接得到全部链接
    List<String> imageLinks = await Future.wait(uploadTasks);
    print('所有图片下载链接：$imageLinks');
  }
}

注意事项 #

• 确保Firebase Storage的安全规则允许当前用户执行上传和读取操作，否则会触发权限错误。
• uuid.v1()和uuid.v4()均可生成唯一标识，保持你原有的用法即可。

内容的提问来源于stack exchange，提问作者Ja'afar Zakariya