如何使用条件字段路径向Firebase Firestore嵌套字段添加数据

前提说明 #

Firestore目前不支持直接通过数组内部对象的属性条件来定位更新对应的子数组，你期望的直接传入带筛选条件的FieldPath来更新的方式原生不支持，必须先定位到符合条件的分类在顶层数组中的下标，再构造对应路径执行更新。

实现方案（Dart/Flutter环境） #

方案1：读-改-写（通用稳妥方案） #

先拉取文档现有数据，定位Cars分类下标后执行更新，代码如下：

// 待添加的Tesla数据
Map _map = {
  "productName": 'Tesla',
  "quantity": 2,
  "costPrice": 45000,
  "coverPhoto": "www.teslaPhotoUrl.jpg"
};

// 1. 先获取目标文档的现有数据
DocumentSnapshot doc = await _firebaseFirestoreRef.collection('data').doc(id).get();
// 此处的'k'对应你示例中顶层数组的存储字段名，需替换为你实际的字段名
List<dynamic> categoryList = doc.get('k');

// 2. 查找category为Cars的元素下标
int targetIndex = categoryList.indexWhere((item) => item['category'] == 'Cars');
if (targetIndex == -1) {
  // 无Cars分类的自定义处理逻辑，比如主动新增Cars分类节点
  return;
}

// 3. 构造对应products数组的字段路径
String fieldPath = 'k.$targetIndex.products';

// 4. 执行arrayUnion更新
await _firebaseFirestoreRef.collection('data').doc(id).update({
  fieldPath: FieldValue.arrayUnion([_map])
});

方案2：事务优化（解决并发修改问题） #

如果你的场景可能存在多端同时修改同一条文档的情况，建议用事务保证数据一致性，避免更新覆盖：

await _firebaseFirestoreRef.runTransaction((transaction) async {
  DocumentSnapshot snapshot = await transaction.get(_firebaseFirestoreRef.collection('data').doc(id));
  if (!snapshot.exists) {
    throw Exception("目标文档不存在");
  }
  List<dynamic> categoryList = snapshot.get('k');
  int targetIndex = categoryList.indexWhere((item) => item['category'] == 'Cars');
  if (targetIndex == -1) {
    // 无Cars分类的自定义处理逻辑
    return;
  }
  String fieldPath = 'k.$targetIndex.products';
  transaction.update(snapshot.reference, {
    fieldPath: FieldValue.arrayUnion([_map])
  });
});

方案3：固定下标更新（仅适合数组顺序固定的场景） #

如果你能保证Cars分类永远在顶层数组的第0位（第一个元素），可以不用读数据直接硬编码路径：

await _firebaseFirestoreRef.collection('data').doc(id).update({
  'k.0.products': FieldValue.arrayUnion([_map])
});

注意事项 #

• 代码中的k是你示例中顶层数组的变量名，需要替换为你实际在Firestore中存储该数组的字段名
• arrayUnion会自动判断待添加的元素是否已存在于数组中，完全一致的元素不会重复添加，如果需要强制添加可直接修改整个数组后覆盖写入

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