Flutter中如何自定义UID（含用户名）向Firestore写入用户文档？

1. 使用Firebase Auth生成的UID作为Firestore文档ID #

你当前代码里用FirebaseFirestore.instance.collection('Users').add(userlogin)会自动生成随机文档ID，要改成用Auth返回的用户UID作为ID，只需要把add()换成doc(user.uid).set()即可。另外建议把Firestore写入操作放在导航之前，并添加错误处理，避免用户跳转后数据写入失败的情况：

修改后的代码片段：

if (user != null) {
  try {
    // 用Auth用户的UID作为文档ID写入Firestore
    await FirebaseFirestore.instance
        .collection('Users')
        .doc(user.uid) // 指定文档ID为用户UID
        .set(userlogin);
    print("User is successfully created and data saved");
    Navigator.pushAndRemoveUntil(
      context,
      MaterialPageRoute(builder: (context) => Home()),
      (route) => false,
    );
  } catch (e) {
    print("Failed to save user data: $e");
  }
} else {
  print("Some error happened");
}

2. 使用用户名作为Firestore文档ID（替代系统UID） #

如果要把用户名作为文档ID，核心要求是用户名必须唯一（Firestore不允许同一集合下存在重复文档ID），因此需要调整流程：先校验用户名是否已存在，再创建Auth用户，最后用用户名作为ID写入数据。

修改后的_signUp方法示例：

void _signUp() async {
  String username = _usernameController.text.trim();
  String email = _emailController.text.trim();
  String password = _passwordController.text.trim();

  // 先检查用户名是否已被使用
  final usernameDoc = await FirebaseFirestore.instance
      .collection('Users')
      .doc(username)
      .get();
  
  if (usernameDoc.exists) {
    print("Username already taken");
    return;
  }

  Map<String, String> userlogin = {
    'name': username,
    'email': email,
  };

  try {
    User? user = await _auth.signupWithEmailAndPassword(email, password);
    if (user != null) {
      // 用用户名作为文档ID写入Firestore
      await FirebaseFirestore.instance
          .collection('Users')
          .doc(username)
          .set(userlogin);
      print("User is successfully created and data saved");
      Navigator.pushAndRemoveUntil(
        context,
        MaterialPageRoute(builder: (context) => Home()),
        (route) => false,
      );
    }
  } catch (e) {
    print("Error during signup: $e");
  }
}

注意事项 #

• 限制用户名格式：Firestore文档ID不允许包含/、\、#、[、]等特殊字符，需要在前端对用户名做格式校验
• 强化唯一性校验：高并发场景下，仅靠前置查询可能出现重复注册问题，建议用Firestore事务或者添加用户名的唯一性索引来保证数据一致性
• 权衡方案选择：如果后续需要关联用户的其他业务数据（比如订单、收藏），更推荐保留Firebase Auth生成的UID作为文档ID，同时将用户名作为文档字段存储——这样既保证了文档ID的全局唯一性，又能通过用户名灵活查询用户数据

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