Flutter中Firestore现有文档更新异常：setData创建新文档排查

看起来你遇到的核心问题是调用setData时创建新文档而非更新现有文档，这主要是两个关键问题导致的：路径格式错误，以及更新时没有传递现有文档的ID。

1. 路径末尾的多余斜杠导致无效路径 #

首先看你的APIPath类：

static String rackBookItems(
 String uid, String id) => 'rackBookItems/$id/';

Firestore的文档路径格式是集合名/文档ID，不能以斜杠结尾。末尾的斜杠会让Firestore识别为无效路径，最终导致创建新的文档（甚至可能是嵌套的空文档）。

修复：去掉路径末尾的斜杠 #

class APIPath {
 static String rackBookItems(String uid, String id) => 'rackBookItems/$id';
}

2. 更新时没有传递现有文档的ID #

在_completed方法中，你创建了一个新的RackBookItems实例，但只传入了checkBox，没有保留原文档的id：

final rackBookItems = RackBookItems(checkBox: checkBox);

没有ID的话，APIPath.rackBookItems方法会使用null作为文档ID，Firestore会自动生成一个新的随机ID，从而创建新文档。

修复步骤： #

第一步：给RackBookItems添加copyWith方法

这个方法可以帮你基于现有实例创建新实例，保留原有字段，只更新需要修改的部分：

class RackBookItems {
 // ... 原有代码 ...
 
 RackBookItems copyWith({
  String id,
  String rackId,
  String title,
  bool checkBox,
 }) {
  return RackBookItems(
    id: id ?? this.id,
    rackId: rackId ?? this.rackId,
    title: title ?? this.title,
    checkBox: checkBox ?? this.checkBox,
  );
 }
}

第二步：基于原有文档实例更新

修改_completed方法，使用copyWith来创建更新后的实例，确保保留原文档的ID：

Future<void> _completed() async {
 if (_validateAndSaveForm()) {
  try{
    // 如果你是要切换checkBox的状态，取反原有值；如果是从表单获取，这里替换成表单的值
    final updatedCheckBox = !(widget.rackBookItems?.checkBox ?? false);
    // 使用copyWith保留原文档的id、rackId、title，只更新checkBox
    final rackBookItems = widget.rackBookItems.copyWith(checkBox: updatedCheckBox);
    await widget.database.setRackBook(rackBookItems);
    Navigator.of(context).pop();
  } on PlatformException catch (e) {
    PlatformExceptionAlertDialog(
      title: 'Operations failed',
      exception: e,
    ).show(context);
  }
 }
}

3. 额外优化：避免重复创建Database Provider #

在PageScreen的build方法中，你已经通过构造函数接收了database参数，但又在StreamBuilder里重新创建了一个Provider<Database>，这会导致不必要的重复创建。可以简化这部分代码：

// 替换原来的StreamBuilder部分
Text('Data'),

因为你已经在show方法中获取了database并传入了PageScreen，所以不需要在build里再次创建Provider。

验证修复效果 #

完成以上修改后，当你调用setData时，会使用现有文档的ID生成正确的路径，Firestore就会执行更新操作而非创建新文档。

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