在Flutter中如何更新Firebase Firestore文档且不覆盖子集合？

首先明确核心事实：Firestore的文档和其关联的子集合是完全独立的存储实体——更新父文档本身不会删除或覆盖子集合。你需要关注的是避免误替换整个父文档，而是精准更新指定字段。

1. 优先使用update()方法（推荐） #

update()方法只会修改你明确指定的字段，文档中其他现有字段保持不变，完全不会触及子集合。

示例代码：

import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> updateTargetDocument() async {
  try {
    // 获取目标文档的引用
    final docRef = FirebaseFirestore.instance
        .collection('yourParentCollection')
        .doc('targetDocId');

    // 仅更新指定字段，其余字段不受影响
    await docRef.update({
      'username': 'new_username',
      'lastUpdated': FieldValue.serverTimestamp(),
    });
    print('文档更新成功');
  } catch (e) {
    print('更新失败: $e');
  }
}

2. 若使用set()，务必开启merge: true #

如果习惯用set()方法，必须添加SetOptions(merge: true)参数。不带此参数的set()会完全替换整个文档（删除原有所有字段，只保留传入的字段），但即便如此，子集合依然会被保留——只是父文档本身被替换了。开启merge后，效果和update()一致，仅更新指定字段。

示例代码：

Future<void> setDocumentWithMerge() async {
  final docRef = FirebaseFirestore.instance
      .collection('yourParentCollection')
      .doc('targetDocId');

  // 合并更新，仅修改指定字段
  await docRef.set(
    {
      'email': 'updated@example.com',
    },
    SetOptions(merge: true),
  );
}

关于子集合的额外提示 #

• 子集合的存储路径独立于父文档（例如yourParentCollection/targetDocId/yourSubCollection），父文档的任何字段操作都不会影响子集合的内容。
• 若需要更新子集合内的文档，需单独获取子集合的文档引用进行操作，这和父文档的更新是完全独立的流程。

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