Flutter Firebase开发中如何向Cloud Firestore列表字段追加元素

问题根因 #

1. 你的toDocument()方法返回类型是Map<String, Object>，你在更新逻辑中强制将其转为List属于类型错误，运行时会直接抛出异常。
2. FieldValue.arrayUnion()接收的参数是需要追加到列表中的目标元素本身，而你当前toDocument()返回的Map中orderCheckoutDetails是包裹了单个订单的列表，结构与追加需求不匹配。

解决方案 #

第一步：调整Checkout类的结构转换方法 #

新增单独提取单个订单Map的方法，同时复用该方法优化原有toDocument逻辑，避免重复代码：

// 新增：返回单个订单的Map结构，不需要额外包裹列表
Map<String, dynamic> toOrderItem() {
  Map customerAddress = Map();
  Map orderCheckoutDetails = Map();

  final DateTime now = DateTime.now();
  final DateFormat formatter = DateFormat('dd-MM-yyyy');
  final String formatted = formatter.format(now);

  customerAddress['address'] = this.address;
  customerAddress['city'] = this.city;
  customerAddress['state'] = this.state;
  customerAddress['zipCode'] = this.zipCode;

  orderCheckoutDetails['checkoutOrderDate'] = formatted;
  orderCheckoutDetails['customerAddress'] = customerAddress;
  orderCheckoutDetails['customerName'] = '${this.nome!} ${this.cognome!}';
  orderCheckoutDetails['customerPhone'] = this.numeroTelefono!;
  orderCheckoutDetails['products'] = this.products!.map((product) => product.name).toList();
  orderCheckoutDetails['subtotal'] = this.subtotal!;
  orderCheckoutDetails['deliveryFee'] = this.deliveryFee!;
  orderCheckoutDetails['total'] = this.total!;

  return orderCheckoutDetails;
}

// 原有方法优化，复用上面的逻辑
Map<String, Object> toDocument() {
  return {
    'orderCheckoutDetails': [toOrderItem()],
  };
}

第二步：修改文档更新逻辑 #

调用arrayUnion时传入要追加的单个订单元素即可：

@override
Future<void> addCheckout(Checkout checkout) async {
  print(checkout.email!);

  final docExists = await _checkIfUserCheckoutExists(checkout.email!);
  print(docExists);

  if (!docExists) {
    return _checkoutCollection
        .doc(checkout.email!)
        .set(checkout.toDocument());
  } else {
    await _checkoutCollection.doc(checkout.email!).update({
      "orderCheckoutDetails": FieldValue.arrayUnion([checkout.toOrderItem()])
    });
  }
}

注意事项 #

FieldValue.arrayUnion会自动对元素去重，如果你的业务允许同一用户下存在完全相同的订单数据，需要替换为先读取现有列表、本地追加后再回写的逻辑：

// 允许重复订单的更新逻辑
else {
  final docSnapshot = await _checkoutCollection.doc(checkout.email!).get();
  List existingOrders = docSnapshot.get('orderCheckoutDetails') ?? [];
  existingOrders.add(checkout.toOrderItem());
  await _checkoutCollection.doc(checkout.email!).update({
    "orderCheckoutDetails": existingOrders
  });
}

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