如何使用Firestore的ArrayUnion方法更新二维嵌套数组

arrayUnion 是Firestore提供的数组增量更新操作符，仅支持直接对文档的顶层数组字段做追加去重操作，没有原生语法支持直接定位数组元素内部的二级嵌套数组执行更新，没法通过单次update调用直接给units数组里某个对象的subunits字段做arrayUnion。

可落地的实现方式 #

方式一：事务+本地修改后写回（无需调整现有数据结构） #

这是兼容当前数据结构的标准实现，核心逻辑是先读取文档数据，在本地完成嵌套数组的去重追加，再把修改后的数组整体写回，用事务保证并发安全。
示例代码：

const subjectRef = db.collection('subjects').doc('exampleDoc')

// 使用事务避免并发写入覆盖问题
await db.runTransaction(async (tx) => {
  const snap = await tx.get(subjectRef)
  const data = snap.data()

  // 定位到需要添加subunit的目标unit，替换成实际业务的匹配逻辑
  const targetUnitPos = data.units.findIndex(unit => unit.id === '123456787654323456765')
  if (targetUnitPos < 0) return // 目标unit不存在时可自定义处理逻辑

  const targetUnit = data.units[targetUnitPos]
  // 初始化subunits字段
  if (!targetUnit.subunits) targetUnit.subunits = []

  const newSubunit = { id: '234568765434567', name: 'Example Subunit' }
  // 模拟arrayUnion的去重逻辑：同id元素已存在则不重复添加
  const isExisted = targetUnit.subunits.some(item => item.id === newSubunit.id)
  if (!isExisted) targetUnit.subunits.push(newSubunit)

  // 写回修改后的units数组
  tx.update(subjectRef, { units: data.units })
})

不要跳过事务直接读了再写，否则多端同时修改同一份units数据时，会出现后写入的内容覆盖之前更新的问题。

方式二：调整数据结构，直接使用arrayUnion（性能更好） #

如果这类嵌套数组更新操作很频繁，建议调整数据模型，避免每次更新都读取整个文档：
把原本嵌套在units数组元素里的subunits，拆分到独立文档存储：给subjects文档下新增名为units的子集合，每个unit作为子集合里的独立文档，subunits作为unit文档下的顶层数组字段。
调整后可以直接用arrayUnion更新，不需要读取父文档，代码如下：

// 直接定位到目标unit文档
const unitRef = db.collection('subjects').doc('exampleDoc')
  .collection('units').doc('123456787654323456765')

// 直接调用arrayUnion更新subunits，和更新一维数组的写法完全一致
await unitRef.update({
  subunits: firestore.FieldValue.arrayUnion({
    id: '234568765434567',
    name: 'Example Subunit'
  })
})

这种建模方式除了支持直接用arrayUnion，后续对单个unit的查询、修改、删除性能都会比操作大数组更好，是Firestore官方更推荐的嵌套数据建模方式。

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