如何限制Flutter用户在Firestore指定集合中仅创建一个文档？

针对你遇到的无网重复提交导致多文档的问题，可通过以下几种方式解决：

1. 使用固定文档ID替代随机生成（最直接有效） #

不要用add()方法自动生成随机ID，而是给personalInfo集合指定一个固定的文档ID（比如'user_profile'），每次提交时用set()方法写入。这样无论用户提交多少次，都会覆盖同一个文档，不会产生多个条目。

修改后的提交代码：

try {
  await FirebaseFirestore.instance
      .collection('users')
      .doc(userID)
      .collection('personalInfo')
      .doc('user_profile') // 固定文档ID
      .set(_insertProfInfoToDBToDB.toJson(), SetOptions(merge: true)); // merge可选，保留原有未修改字段
  // 提交成功提示
} catch (e) {
  // 处理异常
}

如果不需要合并字段，直接去掉SetOptions参数即可，每次提交会完全覆盖文档内容。

2. 添加提交状态锁，防止重复点击 #

在页面中添加一个_isSubmitting状态变量，点击提交按钮时先检查该状态，若正在提交则直接返回，避免重复触发请求。

示例代码：

bool _isSubmitting = false;

// 提交按钮的点击事件
Future<void> _submitForm() async {
  if (_isSubmitting) return; // 正在提交时阻止重复点击
  
  setState(() {
    _isSubmitting = true;
  });

  try {
    // 执行Firestore写入操作
    await FirebaseFirestore.instance
        .collection('users')
        .doc(userID)
        .collection('personalInfo')
        .doc('user_profile')
        .set(_insertProfInfoToDBToDB.toJson());
    
    Utils.showSnackBar("提交成功");
  } catch (e) {
    await _tryConnection(); // 调用你的网络检查函数
  } finally {
    setState(() {
      _isSubmitting = false; // 无论成功失败，都重置状态
    });
  }
}

同时，按钮可以根据_isSubmitting状态禁用或显示加载状态，比如：

ElevatedButton(
  onPressed: _isSubmitting ? null : _submitForm,
  child: _isSubmitting 
      ? CircularProgressIndicator(size: 20) 
      : Text("提交"),
)

3. 用Firestore安全规则限制文档数量 #

通过安全规则确保每个用户的personalInfo集合最多只能有一个文档，从后端层面限制创建行为。

示例安全规则：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userID}/personalInfo/{docID} {
      allow create: if request.auth.uid == userID 
                  && exists(/databases/$(database)/documents/users/$(userID)/personalInfo) == false;
      allow update, delete: if request.auth.uid == userID;
    }
  }
}

这个规则会检查用户创建新文档时，该集合是否已有文档，若已有则拒绝创建请求。不过这种方式需要结合前端状态控制，因为无网时规则无法即时生效，还是可能出现本地缓存多提交的情况，所以建议和前两种方式配合使用。

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