Flutter Firebase修改MFA用户邮箱报错：multifactor users must always have a verified email

核心问题原因 #

Firebase 修改邮箱属于敏感操作，即使当前邮箱已验证，也必须先重新验证用户身份，否则会触发权限错误，同时也不会发送验证邮件给新邮箱。

具体解决方案 #

1. 先重新验证用户身份

不管用户是否开启MFA，都需要先调用reauthenticateWithCredential方法完成身份二次验证，再执行修改邮箱操作。

• 对于未开启MFA的用户，用邮箱密码凭证重新验证：

onPressed: () async {
  try {
    var currentUser = FirebaseAuth.instance.currentUser;
    if (currentUser == null) return;

    // 从输入框获取用户当前密码
    String userEmail = currentUser.email!;
    String userPassword = passwordInput.text;

    // 创建邮箱密码凭证
    AuthCredential credential = EmailAuthProvider.credential(
      email: userEmail,
      password: userPassword,
    );

    // 重新验证身份
    await currentUser.reauthenticateWithCredential(credential);

    // 验证通过后修改邮箱
    await currentUser.updateEmail(newEmail.text);

    // 修改成功，Firebase会自动给新邮箱发送验证邮件
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text("邮箱修改请求已发送，请查收新邮箱的验证邮件")),
    );
  } on Exception catch (e) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text(e.toString())),
    );
  }
},

• 对于开启MFA的用户，需额外处理多因素验证流程：
  如果用户开启了MFA，重新验证时会抛出FirebaseAuthException（错误码requires-mfa），此时需要引导用户输入MFA验证码完成二次验证：

onPressed: () async {
  try {
    var currentUser = FirebaseAuth.instance.currentUser;
    if (currentUser == null) return;

    String userEmail = currentUser.email!;
    String userPassword = passwordInput.text;
    AuthCredential credential = EmailAuthProvider.credential(
      email: userEmail,
      password: userPassword,
    );

    try {
      // 尝试重新验证，有MFA则抛出异常
      await currentUser.reauthenticateWithCredential(credential);
    } on FirebaseAuthException catch (e) {
      if (e.code == 'requires-mfa') {
        // 获取MFA会话凭证
        var session = await currentUser.multiFactor.getSession();
        // 从输入框获取用户MFA验证码
        String mfaCode = mfaInput.text;
        
        // 获取用户已注册的MFA设备（以短信/电话MFA为例）
        PhoneMultiFactorInfo? mfaDevice;
        for (var factor in currentUser.multiFactor.enrolledFactors) {
          if (factor is PhoneMultiFactorInfo) {
            mfaDevice = factor;
            break;
          }
        }
        if (mfaDevice == null) throw Exception("未找到已注册的MFA设备");

        // 创建MFA断言凭证
        var assertion = await PhoneMultiFactorGenerator.getAssertion(mfaDevice, mfaCode);
        // 完成MFA验证
        await currentUser.reauthenticateWithCredential(credential, assertion: assertion);
      } else {
        throw e;
      }
    }

    // 验证通过后修改邮箱
    await currentUser.updateEmail(newEmail.text);
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text("邮箱修改请求已发送，请查收新邮箱的验证邮件")),
    );
  } on Exception catch (e) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text(e.toString())),
    );
  }
},

2. 确认Firebase邮件模板配置

登录Firebase控制台，进入「Authentication」→「Templates」，找到「Email address change」模板：

• 确保模板处于启用状态
• 检查模板收件人设置为新邮箱地址，内容配置正常
• 若未收到邮件，排查新邮箱的垃圾邮件文件夹，或确认Firebase邮件发送渠道未被拦截

关键注意事项 #

• 必须让用户再次输入当前密码（或MFA验证码），这是Firebase的安全要求，无法跳过
• 修改邮箱后，Firebase会自动向新邮箱发送验证邮件，无需手动调用发送方法
• 若仍报错，可查看错误码对应Firebase官方文档的具体说明，排查权限或配置问题

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