Flutter手机号登录出现RecaptchaVerifier未实现报错、等待久如何解决

UnimplementedError: RecaptchaVerifier is not implemented报错的触发原因非常明确：

• RecaptchaVerifier的手动初始化逻辑仅适用于Web端Flutter应用，Android、iOS等移动端平台的Firebase Auth插件，默认会自动生成并管理reCaptcha验证实例，完全不需要开发者手动调用构造函数创建
• 很多开发者从Web端迁移业务代码到移动端时，会不小心把Web端手动创建RecaptchaVerifier的逻辑拷贝到移动端，由于移动端平台接口没有注册对应的实现逻辑，就会直接抛出未实现异常
• 日志里记录的偶发登录成功、流程等待时间长、SafetyNet Token获取失败的问题，和这段错误代码逻辑、Firebase安全校验配置缺失直接相关

1. 清理冗余的手动RecaptchaVerifier代码 #

直接删除代码中手动创建RecaptchaVerifier的逻辑，移动端调用手机号登录接口时不需要显式传入自定义verifier：

• 错误写法（会触发未实现异常）：

  // 删掉整段手动初始化的代码
  final verifier = RecaptchaVerifier(
    auth: FirebaseAuth.instance,
    container: 'recaptcha-container',
  );
  await FirebaseAuth.instance.signInWithPhoneNumber(phoneNumber, verifier);
  

• 正确的移动端实现：

  // 平台会自动处理验证环节，不需要手动创建verifier
  await FirebaseAuth.instance.signInWithPhoneNumber(
    phoneNumber,
    autoVerifyTimeout: const Duration(seconds: 30),
  );
  

  注：如果需要自定义验证UI（比如强制显示reCaptcha验证弹窗），使用插件提供的自动生成的verifier实例即可，不要直接调用RecaptchaVerifier的公开构造函数。

2. 解决登录加载慢、偶发失败问题 #

日志中出现的Problem retrieving SafetyNet Token: 7、流程等待久的问题，按以下项对齐配置：

• 核对Android端项目的应用签名SHA-1、SHA-256，确保和Firebase后台登记的应用签名完全匹配，SafetyNet校验依赖正确的签名匹配结果
• 在Firebase Auth设置页开启Play Integrity API校验，替代原有的旧版SafetyNet校验，减少不必要的reCaptcha弹窗触发
• 测试阶段将测试用手机号加入Firebase Auth的测试号码列表，跳过真实短信发送和reCaptcha校验流程，登录验证流程可从十几秒压缩到1-2秒完成
• 将项目依赖的firebase_auth插件升级到当前最新稳定版，不要锁定太旧的版本——4.x早期版本存在移动端平台通道未注册verifier实现的已知bug，升级到5.x以上稳定版后，平台会正确返回verifier实例，从根源上避免未实现异常抛出

3. 添加异常兜底逻辑 #

在手机号登录的调用逻辑外层增加异常捕获，避免平台层的异常直接触发应用崩溃：

try {
  final authResult = await FirebaseAuth.instance.signInWithPhoneNumber(
    phoneNumber,
    autoVerifyTimeout: const Duration(seconds: 30),
  );
} on FirebaseAuthException catch (e) {
  // 处理短信发送失败、校验不通过等业务异常
} catch (e) {
  // 兜底捕获平台接口未实现类异常，避免崩溃
}

内容的提问来源于stack exchange，提问作者Ngô Minh Trung