如何在Flutter中使用Firebase无需邮件链接在APP内重置用户密码

场景一：已登录用户重置密码 #

用户已登录APP时，只需验证当前身份即可直接更新密码，无需依赖邮件链接。

步骤1：验证用户当前身份（避免会话过期） #

若用户登录时长较久，Firebase可能要求重新验证身份才能修改密码。可让用户输入当前密码，通过邮箱凭证完成验证：

import 'package:firebase_auth/firebase_auth.dart';

Future<void> reauthenticateUser(String currentPassword) async {
  final user = FirebaseAuth.instance.currentUser;
  if (user == null) return;

  try {
    final credential = EmailAuthProvider.credential(
      email: user.email!,
      password: currentPassword,
    );
    await user.reauthenticateWithCredential(credential);
    // 验证成功，可继续执行密码更新操作
  } on FirebaseAuthException catch (e) {
    // 处理验证失败场景，如密码错误、用户不存在等
    print(e.message);
  }
}

步骤2：更新密码 #

身份验证通过后，调用updatePassword方法设置新密码：

Future<void> updateUserPassword(String newPassword) async {
  final user = FirebaseAuth.instance.currentUser;
  if (user == null) return;

  try {
    await user.updatePassword(newPassword);
    // 密码更新成功，可向用户展示成功提示
  } on FirebaseAuthException catch (e) {
    switch (e.code) {
      case 'weak-password':
        print('密码强度不足，需至少6位字符');
        break;
      case 'requires-recent-login':
        print('会话已过期，请重新验证身份');
        break;
      default:
        print(e.message);
    }
  }
}

场景二：未登录用户通过手机号OTP重置密码 #

用户忘记密码且不愿使用邮件链接时，可通过手机号接收OTP验证码，验证后直接重置密码。

步骤1：发送OTP验证码 #

用户输入手机号后，调用verifyPhoneNumber发送验证码：

Future<void> sendPhoneOTP(String phoneNumber) async {
  await FirebaseAuth.instance.verifyPhoneNumber(
    phoneNumber: phoneNumber,
    verificationCompleted: (PhoneAuthCredential credential) async {
      // 部分设备支持自动验证，验证成功后直接登录并重置密码
      await FirebaseAuth.instance.signInWithCredential(credential);
      // 登录后调用updatePassword方法
    },
    verificationFailed: (FirebaseAuthException e) {
      print(e.message);
    },
    codeSent: (String verificationId, int? resendToken) {
      // 保存verificationId，用于后续验证码验证
      // 跳转到验证码输入页面
    },
    codeAutoRetrievalTimeout: (String verificationId) {},
  );
}

步骤2：验证OTP并重置密码 #

用户输入验证码后，结合保存的verificationId生成凭证，登录后更新密码：

Future<void> verifyOTPAndResetPassword(String verificationId, String smsCode, String newPassword) async {
  try {
    final credential = PhoneAuthProvider.credential(
      verificationId: verificationId,
      smsCode: smsCode,
    );
    final userCredential = await FirebaseAuth.instance.signInWithCredential(credential);
    await userCredential.user?.updatePassword(newPassword);
    // 密码重置成功
  } on FirebaseAuthException catch (e) {
    print(e.message);
  }
}

注意事项 #

• 密码强度：Firebase默认要求密码至少6位字符，可在Firebase控制台的Auth设置中调整复杂度规则。
• 异常处理：务必捕获FirebaseAuthException，根据错误码给用户对应提示，提升体验。
• 隐私安全：重置流程中避免记录用户输入的密码，防止信息泄露。

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