Firebase Firestore添加数据时如何避免覆盖现有文档？

嗨，这个问题我之前也帮人处理过，你现在遇到的是Firestore set()方法的默认行为问题——它确实会直接替换整个文档，导致旧数据丢失。别担心，有两种简单的方式可以实现“添加/更新数据但不覆盖现有内容”的需求：

方法一：使用set()的合并选项 #

Firestore的set()方法支持传入第二个参数配置合并规则，当你设置merge: true时，如果目标文档已经存在，只会更新你提供的新字段，不会覆盖文档中原本存在的其他字段；如果文档不存在，就会创建新文档并写入数据，一举两得。

PHP代码示例：

// 假设你已经初始化了Firestore客户端
$db->collection('events')
    ->doc('documentNameUsingUniqueEventID')
    ->set(
        [
            'id1' => 'data1',
            'id2' => 'data2',
            // 你要添加/更新的字段
        ],
        ['merge' => true] // 关键的合并选项
    );

方法二：使用update()方法 #

如果你确定目标文档已经存在（不需要处理文档不存在的情况），可以直接使用update()方法。这个方法专门用于更新现有文档的指定字段，不会影响其他未提及的字段，而且如果文档不存在，它会抛出一个异常，适合你明确知道文档已存在的场景。

PHP代码示例：

// 假设你已经初始化了Firestore客户端
$db->collection('events')
    ->doc('documentNameUsingUniqueEventID')
    ->update(
        [
            ['path' => 'id1', 'value' => 'data1'],
            ['path' => 'id2', 'value' => 'data2'],
            // 每个字段用数组形式指定路径和值
        ]
    );

两种方法的区别 #

• set(..., ['merge' => true])：兼容文档存在/不存在两种情况，不存在时创建，存在时合并字段。
• update()：仅适用于文档已存在的情况，不存在会报错，适合明确知道文档存在的更新场景。

根据你的实际需求选择就好啦！

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