如何在Firebase Firestore中添加对象数组？含初始数组不存在场景处理

Firestore 的 arrayUnion 更新操作本身就支持你需要的场景：当目标数组字段不存在时，它会自动创建该数组字段并添加指定元素；若字段已存在且为数组类型，则直接追加元素（注：若元素是对象，只有当对象的键值对完全相同时才会被判定为重复，不会重复添加）。

代码示例（Node.js Admin SDK） #

场景1：更新已存在的文档

const admin = require('firebase-admin');
admin.initializeApp();

const db = admin.firestore();
const docRef = db.collection('vendors').doc('目标文档ID');

// 要添加的车辆数据
const newCars = [
  { model: 'Hyunday', year: 2021 },
  { model: 'BMW', year: 2018 }
];

// 执行更新
docRef.update({
  cars: admin.firestore.FieldValue.arrayUnion(...newCars)
})
.then(() => console.log('数组更新完成'))
.catch(err => console.error('更新失败:', err));

场景2：文档可能不存在（创建+更新）

如果目标文档还未创建，可以结合 set 方法的 merge: true 选项，既创建文档，又实现数组的自动创建/追加：

docRef.set({
  vendor: "XYZ broker",
  phone: "xxx-xxx-xxxx",
  cars: admin.firestore.FieldValue.arrayUnion(...newCars)
}, { merge: true })
.then(() => console.log('文档创建或更新完成'));

merge: true 保证只会更新指定字段，不会覆盖文档中已存在的其他内容，同时 arrayUnion 依然会按规则处理 cars 字段。

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