如何在用户验证新邮箱后同步更新Firebase Firestore邮箱？

你当前的代码逻辑存在核心错误：调用verifyBeforeUpdateEmail后立即检查user!.emailVerified，这个字段仅表示当前登录用户的旧邮箱是否完成验证，和新邮箱的验证状态、更新结果完全无关。此时用户还未点击验证链接，Auth系统里的邮箱根本没更新，所以这个判断要么因旧邮箱已验证而错误执行Firestore更新，要么因旧邮箱未验证而不执行，但都无法关联新邮箱的验证结果。

正确思路是：监听Firebase Auth用户信息的变化，当用户成功验证新邮箱后，Auth中的邮箱会自动更新，此时再同步更新Firestore。

方案1：客户端监听Auth状态变更（推荐） #

在App初始化或页面生命周期中添加用户信息变更监听，当邮箱发生变化时自动同步到Firestore。

步骤1：添加全局/页面级Auth监听 #

@override
void initState() {
  super.initState();
  // 监听用户信息（包括邮箱）的变更
  FirebaseAuth.instance.userChanges().listen((User? user) {
    if (user != null) {
      _syncEmailToFirestore(user.uid, user.email);
    }
  });
}

// 同步Auth邮箱到Firestore
void _syncEmailToFirestore(String uid, String? newEmail) async {
  if (newEmail == null) return;
  
  // 获取Firestore中存储的用户数据
  DocumentSnapshot doc = await FirebaseFirestore.instance.collection('users').doc(uid).get();
  if (!doc.exists) return;
  
  UserModel userData = UserModel.fromDoc(doc);
  // 仅当邮箱不一致时更新
  if (userData.mail != newEmail) {
    await userData.copyWith(mail: newEmail).updateFirestore();
    debugPrint('新邮箱已同步到Firestore');
  }
}

步骤2：修改原updateEmail函数 #

去掉无效的判断逻辑，仅保留发送验证邮件和用户提示：

void updateEmail(String newEmail, BuildContext context, UserModel userData) async {
  FirebaseAuth auth = FirebaseAuth.instance;
  User? user = auth.currentUser;
  try {
    await user!.verifyBeforeUpdateEmail(newEmail);

    if (context.mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(
          content: Text('验证邮件已发送，请查收并点击链接确认邮箱更新'),
        ),
      );
    }
  } catch (e) {
    if (context.mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('更新失败：$e')),
      );
      debugPrint(e.toString());
    }
  }
}

方案2：云函数自动同步（无需客户端处理） #

如果不想在客户端维护监听逻辑，可以用Firebase云函数监听Auth用户的更新事件，当邮箱变更时自动同步到Firestore：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.syncEmailToFirestore = functions.auth.user().onUpdate((change, context) => {
  const oldUser = change.before;
  const newUser = change.after;
  
  // 仅当邮箱发生变化时执行更新
  if (oldUser.email !== newUser.email) {
    return admin.firestore().collection('users').doc(newUser.uid).update({
      mail: newUser.email
    });
  }
  return null;
});

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