Firestore使用set(merge:true)/update时旧字段被置空问题求助

问题根源 #

你遇到的问题核心在于：页面2创建的CheckTimingsModel实例中，未赋值的字段默认是null，调用toMap()后这些null值会被包含在传入Firestore的Map里。

无论是set(SetOptions(merge: true))还是update()方法，当传入的Map包含null值的字段时，Firestore都会将文档中对应字段的值更新为null，而非忽略这些字段。这就导致页面1设置的原有字段被覆盖为空。

解决方案 #

方案1：修改toMap()方法，过滤null值字段 #

在CheckTimingsModel的toMap()方法中，添加逻辑过滤掉值为null的键值对，只保留需要更新的非空字段：

class CheckTimingsModel {
  // ... 你的类字段和构造函数 ...

  Map<String, dynamic> toMap() {
    final Map<String, dynamic> data = {
      'id': id,
      'userName': userName,
      'checkedInAt': checkedInAt?.toIso8601String(),
      'checkedOutAt': checkedOutAt?.toIso8601String(),
      'oilImagePath': oilImagePath,
      'coolantImagePath': coolantImagePath,
      'weeklyTaskDate': weeklyTaskDate?.toIso8601String(),
    };
    // 移除所有值为null的字段
    data.removeWhere((key, value) => value == null);
    return data;
  }
}

这样无论在页面1还是页面2创建model，只有被赋值的字段会被传入Firestore，未赋值的字段不会被包含在Map中，也就不会覆盖文档里的原有值。

方案2：更新前先获取现有文档数据，合并后再保存 #

如果需要确保model的完整性，可以先从Firestore获取目标文档的现有数据，基于现有数据创建新的model实例，再更新需要修改的字段，最后保存：

// 页面2的更新逻辑
void updateCheckTimings(String phn, String id, String oilURL, String coolantURL) async {
  // 获取现有文档数据
  final docSnapshot = await FirebaseFirestore.instance
      .collection("users")
      .doc(phn)
      .collection("checkTimeDetails")
      .doc(id)
      .get();

  if (docSnapshot.exists) {
    final existingData = docSnapshot.data()!;
    // 基于现有数据创建更新后的model
    final updatedModel = CheckTimingsModel(
      id: existingData['id'],
      userName: existingData['userName'],
      checkedInAt: DateTime.parse(existingData['checkedInAt']),
      checkedOutAt: existingData['checkedOutAt'] != null 
          ? DateTime.parse(existingData['checkedOutAt']) 
          : null,
      oilImagePath: oilURL,
      coolantImagePath: coolantURL,
      weeklyTaskDate: DateTime.now(),
    );
    // 调用保存方法
    await _dbServices.addDataToDBSubCollection(
      "users",
      phn,
      "checkTimeDetails",
      id,
      updatedModel.toMap(),
    );
  }
}

这种方式可以保证所有原有字段都被保留，只更新需要修改的内容，适合需要维护完整model结构的场景。

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