Firestore如何在开启set merge模式时全量替换指定Map字段

我有一个接收多字段参数的 PUT: /users 接口。多数场景下，我希望对文档调用带 {merge: true} 参数的 .set 方法，实现单独更新指定文档字段且不删除其他字段的效果，但在另一个场景下，我需要更新某个Map字段，使其仅包含单个值。

现有文档结构与业务诉求 #

初始用户文档结构如下：

// user doc
displayName: 'Frank'
age: 28
gender: {
  male: true
}
orientation: {
  female: true
}

我的具体需求是：

• displayName 与 age 这类普通字段，适合走合并更新逻辑，不需要每次提交全量字段
• gender 和 orientation 这类嵌套Map字段，需要用新值完全替换原有整个Map内容，不能逐字段递归合并

之所以保留嵌套Map结构，是因为我开发的是婚恋交友应用，需要支撑灵活的多条件组合查询，比如这类查询逻辑：

db
  .collection('users')
  .where(`gender.${myOrientation}`, '==', true)
  .where('gender.all', '==', true) // 匹配非性别定向的用户

我也试过数组结构的实现，但Firestore的查询限制每次请求仅能使用1次数组查询，完全满足不了多条件组合的查询需求。

目前遇到的问题 #

当我调用 ...doc.set({ gender: {female: true} }, {merge: true}); 时，因为merge参数的递归合并特性，最终生成的文档结构不符合预期：

displayName: 'Frank'
age: 28
gender: {
  male: true,
  female: true,
}
orientation: {
  female: true
}

而我实际想要的完全替换效果是：

displayName: 'Frank'
age: 28
gender: {
  female: true
}
orientation: {
  female: true
}

针对Firestore merge: true 会递归合并嵌套Map的底层特性，完全替换嵌套Map有3种适配不同场景的实现方式，不会破坏原有普通字段的合并更新逻辑：

方案1：原子分步更新 #

利用 update 方法的原子操作特性，先对需要替换的Map路径执行删除操作，再写入新的Map值，全程无中间态：

const userRef = db.collection('users').doc(userId);
await userRef.update({
  // 先删除整个gender字段的所有旧内容
  gender: firebase.firestore.FieldValue.delete(),
  // 再写入新的Map值，其他需要合并的普通字段可以一并传入
  'gender.female': true,
  displayName: 'Frank',
  age: 28
})

这种方式和原有其他字段的合并更新逻辑完全兼容，不需要对现有代码的其他部分做调整。

方案2：指定字段级合并范围 #

Firestore的set(..., {merge: true}) 支持传入字段路径数组，自定义指定哪些路径需要走合并逻辑、哪些路径需要直接全量替换，避免全局递归合并的问题：

await userRef.set({
  // 普通字段正常写入
  displayName: 'Frank',
  age: 28,
  // 需要替换的Map字段直接传入新值
  gender: { female: true }
}, {
  // 仅指定普通字段走合并逻辑，gender字段直接全量替换
  mergeFields: ['displayName', 'age', 'orientation']
})

这种方式可以一次请求处理混合的更新需求，不需要拆分多次接口调用。

方案3：文档结构扁平化 #

既然嵌套Map的递归合并是Firestore的固有行为，可以把原本嵌套在gender、orientation下的所有键值，提升为独立的顶层平级字段，从根源上规避嵌套Map的合并问题：

// 重构后的文档结构
{
  displayName: 'Frank',
  age: 28,
  // 原本嵌套在gender下的字段直接平铺为独立路径
  gender_male: true,
  gender_female: false,
  gender_all: false,
  // orientation的字段同理平铺
  orientation_female: true
}

调整后再用merge: true更新时，永远不会出现子Map合并残留旧值的问题。对应的查询逻辑只需要调整为平铺后的字段路径即可，查询能力和原本的嵌套Map完全一致，甚至因为减少了嵌套层级，查询性能会更稳定。

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