Firebase手机认证部分设备无法接收OTP问题咨询

阿华AIGC实验室

2026-5-25

Firebase手机认证部分设备收不到OTP的排查方案

你遇到的这个问题其实挺常见的，先直接回答你的核心疑问：Firebase Phone Auth确实有最低API版本限制——要求Android API 16（Android 4.1）及以上，如果你的用户设备系统版本低于这个，大概率会出现功能异常。但如果是API 16+的设备依然收不到OTP，那就要从其他维度排查了，下面给你整理几个关键排查点：

一、基础配置与权限检查

确认Firebase控制台的配置：
- 有没有把你的App的SHA-1和SHA-256指纹都添加进去？不管是debug还是release版本的指纹，少一个都可能导致部分环境下认证失败。
- 项目根目录的google-services.json是不是最新的？如果控制台配置有更新，一定要重新下载替换。

权限声明：在AndroidManifest.xml里确保声明了必要权限（虽然Firebase会自动处理部分，但手动声明更稳妥）：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.READ_SMS" />

二、设备端环境问题

短信拦截/过滤：部分设备自带短信拦截功能，或者用户安装了第三方短信拦截APP，会把Firebase的OTP短信当成垃圾短信拦截，建议让用户检查短信拦截列表。

Google Play Services版本：Firebase Phone Auth依赖Google Play Services，如果设备上的Google Play Services版本过低，会导致功能异常。可以在代码里检查版本，提示用户更新：

GoogleApiAvailability apiAvailability = GoogleApiAvailability.getInstance();
int resultCode = apiAvailability.isGooglePlayServicesAvailable(this);
if (resultCode != ConnectionResult.SUCCESS) {
    if (apiAvailability.isUserResolvableError(resultCode)) {
        apiAvailability.getErrorDialog(this, resultCode, 9000).show();
    }
}

运营商与号码问题：虚拟号码、海外号码（尤其是未在Firebase控制台配置的测试号码）可能无法正常接收OTP；另外部分运营商的短信通道延迟也会导致收不到，建议让用户换个号码或者等几分钟再试。

三、代码实现细节排查

从你提供的代码片段来看，要确保PhoneAuthProvider.OnVerificationStateChangedCallbacks的三个核心方法都正确实现了，这样才能捕获到错误信息，方便定位问题：

mCallbacks = new PhoneAuthProvider.OnVerificationStateChangedCallbacks() {
    @Override
    public void onVerificationCompleted(PhoneAuthCredential credential) {
        // 自动验证成功（比如设备支持SIM卡自动验证），直接用credential登录
        signInWithPhoneAuthCredential(credential);
    }

    @Override
    public void onVerificationFailed(FirebaseException e) {
        // 这里一定要打印或Toast错误信息！比如无效号码、网络问题、配置错误都会触发这里
        Log.e("PhoneAuth", "Verification failed: " + e.getMessage());
        Toast.makeText(context, "验证失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onCodeSent(String verificationId, PhoneAuthProvider.ForceResendingToken token) {
        // OTP发送成功，保存verificationId和token，用于后续手动输入验证码时验证
        super.onCodeSent(verificationId, token);
        mVerificationId = verificationId;
        mResendToken = token;
    }
};

另外，启动验证的代码要确保参数正确，比如号码格式要带国家区号（比如+8613xxxxxxxxx），超时时间设置合理。