Flutter中Firebase手机号认证报错：无效验证ID及Token为空

关于AuthCredential的token为null的说明 #

PhoneAuthProvider.credential生成的AuthCredential中token字段为null是正常现象，Firebase PhoneAuth验证并不依赖这个字段，它只需要verificationId和smsCode的匹配性，所以这个null不是导致错误的原因，无需关注。

verificationID无效的可能原因及解决办法 #

• verificationID被意外覆盖或未正确保存

  • 确保verID是State类的成员变量，避免页面重建、多次点击发送OTP时被重置。多次调用sendOTP会生成新的verificationID，若用户输入旧OTP会导致验证失败。
  • 建议在关键节点打印日志，确认verificationID一致性：

    codeSent: (String verificationId, int? resendToken) async {
      print('CODE SENT, verificationId: $verificationId');
      verID = verificationId;
      token = resendToken;
    },
    

    void HandleOTP() async {
      print('Using verificationId: $verID');
      print('Using smsCode: $smsCode');
      // 后续验证代码
    }
    

• OTP验证码已过期
  Firebase发送的OTP默认有效期为5分钟，过期后对应的verificationID会失效。此时需提示用户重新发送OTP，使用新生成的verificationID进行验证。

• 手机号格式不符合E.164标准
  发送OTP时的phoneNumber必须严格遵循E.164格式（如中国大陆号码为+8613xxxxxxxxx），格式错误会导致生成的verificationID无效，甚至OTP无法正确送达目标号码。

• Firebase配置缺失或错误

  • 检查Firebase控制台是否已开启手机号认证方式；
  • Android端需确认已添加正确的SHA-1和SHA-256指纹，缺失指纹会导致验证失败；
  • iOS端需配置APNs证书或启用Firebase Cloud Messaging推送权限。

• 页面跳转时verificationID传递错误
  若sendOTP和HandleOTP在不同页面，需确保verificationID通过路由参数、状态管理等方式正确传递，避免传递过程中丢失或篡改。

• 添加异常捕获优化
  在HandleOTP中加入异常捕获，精准定位问题并给用户提示：

  void HandleOTP() async {
    final _firebaseAuth = FirebaseAuth.instance;
    try {
      print('Using verificationId: $verID');
      print('Using smsCode: $smsCode');
      final AuthCredential authCredential = PhoneAuthProvider.credential(
        smsCode: smsCode,
        verificationId: verID,
      );
      await _firebaseAuth.signInWithCredential(authCredential);
      // 验证成功后的业务逻辑
    } on FirebaseAuthException catch (e) {
      print('验证失败：${e.message}');
      // 根据错误码给出对应提示，比如invalid-verification-id时提示重新发送OTP
    } catch (e) {
      print('未知错误：$e');
    }
  }
  

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