Flutter上传多个XFile至Firebase Storage仅成功1个且Firestore写入失败

故障来自两处明确的代码错误：

1. 仅1张图上传成功、Firestore无数据写入的核心原因：Future.wait(images.map((_image) => uploadFile(_image)))返回的imageUrls本身就是包含所有图片下载地址的List<String>集合，你在给productImg字段赋值时，额外给imageUrls套了一层方括号，传给FieldValue.arrayUnion的实际是List<List<String>>嵌套结构，类型不匹配会直接抛出运行时异常，中断后续所有执行逻辑。你当前catch块直接把原始错误对象err覆盖成了固定提示文案，所以控制台看不到真实报错信息。
2. 用images.forEach()遍历报void错误是Dart的正常机制：Iterable.forEach方法返回值固定为void，无法等待内部异步任务执行完成，批量跑异步上传必须用map配合Future.wait的写法，你之前的图片上传遍历逻辑本身没有问题。

首先修正Firestore写入时的数组嵌套问题，同时优化异常捕获和上下文判断逻辑，修复后的addProduct代码如下：

Future<void> addProduct({
  BuildContext? ctx,
  String? proName,
  String? productDescription,
  double? count,
  double? price,
  required List<XFile> images
}) async {
  try {
    // 批量等待所有图片上传完成，拿到全部下载链接
    final imageUrls = await Future.wait(images.map((_image) => uploadFile(_image)));

    await firestore
        .collection(outletsCollection)
        .doc(_currentUserOutletId)
        .set({
      products: FieldValue.arrayUnion([
        {
          productId: Uuid().v4(),
          productName: proName,
          prodDesc: productDescription,
          countInStock: count,
          productPrice: price,
          // 修复点：移除imageUrls外层多余的方括号，直接传入字符串列表即可
          productImg: FieldValue.arrayUnion(imageUrls),
        }
      ]),
    }, SetOptions(merge: true));
  } catch (err) {
    // 打印原始错误方便排查问题，不要直接吞错
    debugPrint("商品上传失败: $err");
    const errMsg = "上传失败，请检查网络后重试";
    if (ctx != null && ctx.mounted) {
      errorDialog(ctx, errMsg);
    }
  }
  notifyListeners();
}

补充说明 #

• 你写的uploadFile方法已经兼容Web和移动端的XFile类型，不需要做额外修改
• 给set方法增加SetOptions(merge: true)是为了避免目标文档已存在时，覆盖掉文档内除products字段外的其他原有数据
• 弹出错误对话框前增加mounted判断，是为了避免用户在上传过程中退出页面，导致上下文失活触发报错
• 如果修复后仍然出现上传中断，优先检查Firebase Storage安全规则是否开放了对应路径的写入权限，以及应用是否拿到了本地文件读取权限。

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