Firebase Firestore v9最佳实践：选ignoreUndefinedProperties还是条件addDoc/updateDoc？

Firebase 9 非必填字段更新方案说明 #

1. 两种方案最优选择 #

针对你提到的多集合、大量非必填字段的场景，优先选择开启ignoreUndefinedProperties方案，比手动写条件判断组装更新对象的维护成本低得多，也能避免漏写判断导致的报错问题，和你理解的作用一致：该配置就是自动过滤值为undefined的字段，不需要你手动修改大量操作函数。

2. Firebase 9 模块化版本ignoreUndefinedProperties配置方法 #

该配置需要在初始化Firestore实例时传入，不要使用默认的getFirestore()方法，改用initializeFirestore传入配置即可：

import { initializeApp } from "firebase/app";
import { initializeFirestore } from "firebase/firestore";

// 替换为你的Firebase配置
const firebaseConfig = {
  apiKey: "xxx",
  authDomain: "xxx",
  projectId: "xxx",
  storageBucket: "xxx",
  messagingSenderId: "xxx",
  appId: "xxx"
};

const app = initializeApp(firebaseConfig);
// 初始化Firestore时开启ignoreUndefinedProperties
const db = initializeFirestore(app, {
  ignoreUndefinedProperties: true
});

配置开启后，所有updateDoc、setDoc操作都会自动忽略值为undefined的字段，不会再触发你遇到的Unsupported field value: undefined报错。

注意：如果需要主动删除文档中的某个字段，不要传undefined，需要使用Firebase提供的deleteField()方法。

3. 条件判断方案适用场景 #

如果仅存在少量操作、非必填字段少于3个，可以选用条件判断方案，不需要修改全局Firestore配置。

StackOverflow规范说明 #

在问题正文追加编辑补充上下文信息是完全符合平台规范的做法，补充报错信息、业务场景（如字段数量、操作次数）等内容，能帮助其他用户更精准地回答你的问题，属于推荐的问题优化方式。

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