如何使用FieldPath正确批量更新Firestore多个动态嵌套字段

你代码失效的核心是JavaScript普通对象仅支持字符串或Symbol作为键，当你把FieldPath实例作为对象键传入时，它会被自动转为普通字符串，Firestore SDK无法识别该字符串为特殊路径配置，因此嵌套字段更新不会生效。

Firestore的update方法本身支持「路径-值」交替传参的调用格式，既可以传入普通字符串路径，也可以传入FieldPath实例，完全适配多字段混合更新的需求。

单嵌套字段+普通字段更新示例 #

对应你目前的删除指定email字段+更新count的需求，写法如下：

const email = 'test@email.com';
const emailPath = new admin.firestore.FieldPath('email', email);
const docRef = db.collection('collection').doc('document');

// 按 路径1, 值1, 路径2, 值2 的顺序交替传入参数即可
batch.update(
  docRef,
  emailPath, admin.firestore.FieldValue.delete(),
  'count', admin.firestore.FieldValue.increment(1)
);

多嵌套字段批量更新示例 #

如果需要同时更新email Map下的多个字段，直接按顺序追加「路径-值」对即可：

const email1 = 'test1@email.com';
const email2 = 'test2@email.com';
// 生成两个嵌套字段的FieldPath
const emailPath1 = new admin.firestore.FieldPath('email', email1);
const emailPath2 = new admin.firestore.FieldPath('email', email2);
const docRef = db.collection('collection').doc('document');

batch.update(
  docRef,
  emailPath1, admin.firestore.FieldValue.delete(), // 删除第一个email字段
  emailPath2, 'newValue', // 更新第二个email字段的取值
  'count', admin.firestore.FieldValue.increment(1) // 普通字段更新
);

动态生成多字段更新参数 #

如果待更新的嵌套字段是动态生成的，可以先把所有「路径-值」对存入数组，再展开传入：

const updatePairs = [];
// 动态生成要删除的email字段列表
const toDeleteEmails = ['a@test.com', 'b@test.com', 'c@test.com'];
toDeleteEmails.forEach(email => {
  updatePairs.push(new admin.firestore.FieldPath('email', email));
  updatePairs.push(admin.firestore.FieldValue.delete());
});
// 追加普通字段更新
updatePairs.push('count');
updatePairs.push(admin.firestore.FieldValue.increment(1));

const docRef = db.collection('collection').doc('document');
batch.update(docRef, ...updatePairs);

如果你的普通顶层字段名称本身就包含点号，不是用于标识嵌套结构，也需要用FieldPath包裹该字段名，避免SDK把点号识别为嵌套路径分隔符。

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