安卓Firebase手机认证SMS验证码请求失败 状态码17006

该错误是Firebase Auth服务端拦截请求的通用返回码，本质是服务端校验不通过，拒绝了本次短信验证码下发请求。客户端层面对该类错误的透传机制不完善，很多场景下不会主动触发上层页面的回调，导致开发者感知不到流程异常。

服务端配置拦截类原因 #

• 手机号格式不合法：输入的手机号没有携带+开头的国际区号前缀，Firebase后端无法识别合法号码，直接拦截请求
• 登录能力未开通：未在Firebase控制台将手机号登录设置为允许的登录渠道，所有验证请求都会被服务端拒绝
• 应用签名未登记：当前调试设备的应用SHA-1、SHA-256签名指纹没有同步到项目配置中，Firebase的设备校验机制识别不到合法应用来源
• 触发风控规则：短时间内高频重复发起验证码请求，被系统判定为恶意调用，临时拦截该号码的验证权限
• 短信额度耗尽：免费层级的Firebase手机号验证短信额度有限，超量后也会返回17006错误

代码层面的逻辑bug #

• 错误回调是空实现：onVerificationFailed方法没有写任何日志或提示逻辑，所有服务端返回的错误信息都被直接吞掉，造成“没有任何回调触发”的假象
• 验证码校验页的mAuth逻辑完全错误：代码里先初始化了全局的FirebaseAuth实例，之后又尝试从Intent中序列化读取mAuth对象重新赋值，但发送验证码的页面根本没有向Intent传递这个对象，该行代码会直接触发空指针异常
• 验证码读取时机错误：otp变量是在页面创建时就从输入框读取的值，此时页面刚加载完成，用户还未输入任何内容，后续点击验证按钮时，使用的永远是空的otp值
• 参数读取没有做非空校验：直接从Intent中读取verificationId，如果前序流程异常没有传递该值，会直接触发空指针崩溃

• 补全错误回调的日志输出，把被吞掉的错误信息展示出来

  @Override
  public void onVerificationFailed(@NonNull FirebaseException e) {
      Log.e("PhoneAuthDebug", "验证码请求失败", e);
      Toast.makeText(PhoneOtpAuth.this, "请求失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
  }
  

• 发送验证码前对手机号做格式化处理，确保传入的号码带有+开头的国际区号，不要直接把输入框的原始内容传给接口
• 修正验证码校验页的逻辑：
  • 删掉从Intent中读取mAuth的错误代码，直接使用全局初始化的FirebaseAuth单例即可，不需要通过Intent跨页面传递实例
  • 把otp值的读取逻辑移到验证按钮的点击事件中，在用户点击时实时获取输入内容
  • 对从Intent中读取的verificationId做非空校验，避免空指针
    修正后的核心逻辑示例：

  verifyOtp.setOnClickListener(v -> {
      String inputOtp = otpEditText.getText().toString().trim();
      String verificationId = getIntent().getStringExtra("VerificationId");
      if (TextUtils.isEmpty(verificationId) || TextUtils.isEmpty(inputOtp)) {
          Toast.makeText(this, "参数不合法，请重新获取验证码", Toast.LENGTH_SHORT).show();
          return;
      }
      PhoneAuthCredential credential = PhoneAuthProvider.getCredential(verificationId, inputOtp);
      mAuth.signInWithCredential(credential)
          .addOnCompleteListener(task -> {
              if (task.isSuccessful()) {
                  startActivity(new Intent(this, DriverSignup.class));
                  finish();
              } else {
                  Toast.makeText(this, "验证码校验失败，请检查输入", Toast.LENGTH_SHORT).show();
              }
          });
  });
  

• 配置层面校验：确认手机号登录能力已开通、应用签名已同步到项目配置、不要短时间内高频重复发起验证请求触发风控

内容的提问来源于stack exchange，提问作者S. Joshi