Firebase用户邮箱更新（updateEmail已废弃）及数据同步问题排查

你的核心问题在于提前更新了Firestore数据，而verifyBeforeUpdateEmail需要用户点击验证链接后才会真正修改Firebase Auth中的邮箱，导致两者数据不同步。另外，emailVerified是布尔值无法监听，但可以通过Firebase Auth的状态流来检测邮箱变更，实现数据同步。

解决方案步骤： #

1. 移除提前更新Firestore的代码
   只发送邮箱验证链接，不要在用户完成验证前修改Firestore中的邮箱字段，避免数据不一致。

2. 监听Auth状态变化同步数据
   使用FirebaseAuth.instance.authStateChanges()流，该流会在用户Auth信息（包括邮箱）发生变化时触发，此时再同步最新邮箱到Firestore。

3. 添加异常处理避免"用户未找到"错误
   在操作前检查用户状态，捕获Auth相关异常，处理登出、凭证错误等场景。

修改后的代码示例： #

邮箱更新逻辑：

final user = GetCurrentUser().getUser();
if (user == null) {
  // 处理用户未登录场景
  return;
}

try {
  AuthCredential credential = EmailAuthProvider.credential(
    email: oldEmail,
    password: password,
  );

  // 重新验证用户身份
  await user.reauthenticateWithCredential(credential);
  // 发送邮箱验证链接，用户点击后Auth邮箱才会更新
  await user.verifyBeforeUpdateEmail(newEmail);
  
  // 提示用户前往邮箱点击验证链接
} on FirebaseAuthException catch (e) {
  // 捕获并处理异常，比如用户未找到、密码错误、凭证过期等
  print(e.message);
}

监听Auth状态同步Firestore：

在页面初始化时添加监听（比如initState中），确保Auth数据变化时自动同步：

StreamSubscription? authSubscription;
String? _previousEmail;

@override
void initState() {
  super.initState();
  // 记录初始邮箱
  final currentUser = FirebaseAuth.instance.currentUser;
  _previousEmail = currentUser?.email;

  // 监听Auth状态变化
  authSubscription = FirebaseAuth.instance.authStateChanges().listen((User? user) {
    if (user != null && user.email != _previousEmail) {
      // 邮箱发生变化，同步到Firestore
      _previousEmail = user.email;
      FirebaseFirestore.instance.collection("users").doc(user.uid).update({
        "email": user.email,
      }).catchError((error) {
        print("同步邮箱失败: $error");
      });
    }
  });
}

@override
void dispose() {
  // 页面销毁时取消监听，避免内存泄漏
  authSubscription?.cancel();
  super.dispose();
}

说明： #

• 用户点击验证链接后，Firebase Auth会自动更新邮箱，此时authStateChanges流会触发，同步最新邮箱到Firestore，保证两者数据一致。
• 对比_previousEmail可以避免不必要的Firestore更新，只在邮箱真正变化时执行同步。
• 异常处理可以覆盖操作过程中可能出现的用户登出、凭证无效等情况，避免"用户未找到"错误。

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