Flutter中使用Firebase判断指定用户名的文档是否已存在的方法求助

现有代码的核心问题 #

• 调用的snapshots()方法返回的是Firebase实时数据流对象，不是实际的查询结果，直接判断该对象是否为空完全没有业务意义
• Firebase云端查询属于异步操作，你写的同步方法无法等待远端返回结果，自然拿不到正确的校验值
• 即便拿到了查询快照，也需要判断快照内的文档集合是否为空，而非判断快照本身是否为空

正确实现代码 #

因为涉及异步操作，方法需要改为异步返回Future类型，同时用单次查询get()替代不需要的实时数据流监听：

Future<String?> checkUsername(String? username) async {
  // 先校验输入合法性
  if (username == null || username.trim().isEmpty) {
    return "请输入用户名";
  }
  // 单次查询匹配的用户文档，加limit提升查询性能
  final querySnapshot = await FirebaseFirestore.instance
      .collection('User')
      .where("searchname", isEqualTo: username.toLowerCase())
      .limit(1)
      .get();
  
  // 文档为空说明用户名未被占用，否则返回占用提示
  return querySnapshot.docs.isEmpty ? null : "用户名已被使用";
}

调用注意事项 #

异步方法需要用await或者then接收返回结果，调用示例：

// 调用示例
void submitForm() async {
  String? checkResult = await checkUsername(_inputUsernameController.text);
  if (checkResult != null) {
    // 弹出错误提示
    _showToast(checkResult);
    return;
  }
  // 校验通过，执行后续注册/提交逻辑
}

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