Firebase如何检查用户是否已存在：微软登录下实现首次登录存入Firestore数据

核心判断逻辑 #

Firebase Auth 体系下有两种成熟的首次登录判定方式，可根据你当前的代码结构选择适配方案：

• 适配现有代码的轻量判断：借助 User 对象自带的元数据字段判定
  用户完成登录后拿到的 User 实例自带 metadata 属性，其中包含 creationTime（用户账号在Firebase Auth中的创建时间）、lastSignInTime（最近一次登录校验时间）。首次登录的用户，两个时间的差值通常小于10秒（账号刚创建就完成了登录流程）；已存在的老用户，最近登录时间会远晚于账号创建时间，可直接通过该差值判定首次登录状态，不需要改动原有登录流程的代码。
• 精度更高的官方判定：读取认证回调的 isNewUser 标记
  这是Firebase Auth官方提供的原生判断字段，存在于 UserCredential.additionalUserInfo.isNewUser 中，准确率100%，无时间判断的边界问题。若要使用该字段，可在拿到微软登录的身份凭证后，自行调用 FirebaseAuth.signInWithCredential 完成登录流程，即可直接读取该标记。

完整代码实现 #

以下是适配你当前已有代码的可直接运行版本，不需要改动原有的openSignInFlow调用逻辑：

// 原有微软登录逻辑
User user = await FirebaseAuthOAuth().openSignInFlow(
          "microsoft.com", ["email openid"], {'tenant': 'common'});

// 首次登录判定逻辑
final creationTime = user.metadata.creationTime;
final lastSignInTime = user.metadata.lastSignInTime;
final isFirstLogin = creationTime != null &&
    lastSignInTime != null &&
    lastSignInTime.difference(creationTime).inSeconds < 10;

// 首次登录时写入Firestore用户档案
if (isFirstLogin) {
  final userDocRef = FirebaseFirestore.instance.collection('users').doc(user.uid);
  await userDocRef.set({
    'email': user.email,
    'displayName': user.displayName,
    'loginProvider': 'microsoft.com',
    'createdAt': FieldValue.serverTimestamp(),
    'lastLoginAt': FieldValue.serverTimestamp()
  }, SetOptions(merge: true));
}

注意事项 #

• 写入Firestore时必须使用 SetOptions(merge: true)，即使首次判断出现偏差，也不会覆盖已存在的用户自定义数据，只会补全缺失字段，避免数据丢失
• 不需要在写入前额外调用get()查询文档是否存在，直接带merge的set操作比“先查再写”的流程少一次网络请求，性能更优
• 可在Firestore安全规则中增加文档存在性校验，进一步防止异常状态下的重复写入操作

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