Flutter如何将List<Asset>批量上传到Firebase Storage并获取下载链接列表

Firebase Storage 本身没有提供原生的批量上传接口，但你可以通过 Dart 的 Future.wait 实现并行批量上传，效率和原生批量上传基本一致，同时解决 Asset 类型的转换问题。

第一步：实现单张 Asset 上传逻辑 #

首先你需要将 MultiImagePicker 返回的 Asset 类型转换为 Firebase Storage 支持上传的 Uint8List 格式，完成单张图片的上传和下载链接获取：

import 'dart:typed_data';
import 'package:firebase_storage/firebase_storage.dart';
import 'package:multi_image_picker2/multi_image_picker2.dart';

Future<String> uploadSingleAsset(Asset asset, String userId) async {
  try {
    // 把Asset转换为Uint8List
    ByteData byteData = await asset.getByteData();
    Uint8List imageData = byteData.buffer.asUint8List();
    // 生成唯一文件名，避免同用户上传多张图片时覆盖
    String fileName = '${userId}_${DateTime.now().millisecondsSinceEpoch}.jpg';
    final storageRef = FirebaseStorage.instance.ref().child('user_images').child(fileName);
    // 上传数据
    await storageRef.putData(imageData);
    // 返回下载链接
    return await storageRef.getDownloadURL();
  } catch (e) {
    print('单张图片上传失败: $e');
    // 可根据业务需求调整失败处理逻辑：返回空字符串/抛错终止上传/重试等
    return '';
  }
}

第二步：实现批量并行上传 #

利用 Future.wait 同时执行所有上传任务，所有任务完成后直接返回完整的下载链接列表：

Future<List<String>> uploadBatchAssets(List<Asset> assetList, String userId) async {
  // 把每个Asset都转换为上传任务
  List<Future<String>> uploadTasks = assetList.map((asset) => uploadSingleAsset(asset, userId)).toList();
  // 并行执行所有上传任务，全部完成后返回下载链接列表
  return await Future.wait(uploadTasks);
}

第三步：调用上传并将链接写入 Firestore #

上传完成后直接把返回的链接列表存入 Firestore 即可：

import 'package:firebase_auth/firebase_auth.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

// 调用示例
String uid = FirebaseAuth.instance.currentUser!.uid;
List<Asset> targetAssets = Provider.of<Selling>(context, listen: false).images;
// 批量上传获取链接
List<String> imageUrls = await uploadBatchAssets(targetAssets, uid);
// 过滤掉上传失败返回的空字符串（如果需要）
imageUrls.removeWhere((url) => url.isEmpty);
// 写入Firestore
await FirebaseFirestore.instance.collection('你的集合名').doc('你的文档ID').set({
  'imageUrls': imageUrls,
  // 其他业务字段
});

注意事项 #

• 文件名规则：批量上传时不要直接使用用户UID作为唯一文件名，会导致后上传的图片覆盖先上传的图片，示例中使用「UID+时间戳」的规则可满足大多数场景需求，你也可以根据业务调整。
• 加载状态：上传过程中建议增加全局加载提示，避免用户重复触发上传操作。
• 权限配置：请确保 Firebase Storage 的权限规则允许用户上传文件、获取下载链接。

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