You need to enable JavaScript to run this app. Flutter Android调用Firebase Phone Auth的verifyPhoneNumber时应用崩溃
优惠活动
大模型
产品
解决方案
定价
更多

Flutter Android调用Firebase Phone Auth的verifyPhoneNumber时应用崩溃

Flutter端Firebase手机认证调用时无提示崩溃问题排查

问题复现场景

我遇到的问题与其他同类场景并不一致,此前已经尝试过多个公开技术社区的同类问题解决方案,包括Firebase手机认证触发崩溃、OTP获取阶段报错、认证流程启动时应用闪退等方向的排查方案,全部尝试后均未解决问题。
我在面向Android平台开发的Flutter应用中集成Firebase手机认证能力,当调用Firebase的verifyPhoneNumber方法触发OTP发送流程时,应用会直接退出崩溃,控制台未输出任何Dart层的错误信息。

相关实现代码

final FirebaseAuth _auth = FirebaseAuth.instance;
Future sendOTP(String mobNo, BuildContext context, UserData _userData) async {
  try {
    _auth.verifyPhoneNumber(
        phoneNumber: mobNo,
        verificationCompleted: (val) {
          print("verification completed val = $val");
        },
        verificationFailed: (val) {
          print("verification failed val = $val");
        },
        codeSent: (String verificationId, [int forceResendingToken]) {
          print("code sent to $mobNo");
          Navigator.pushNamed(context, '/get_otp', arguments: {
            'verificationId': verificationId,
            'UserData': _userData,
          });
        },
        codeAutoRetrievalTimeout: (val) {
          print("code auto retrieval timeout val = $val");
        });
  } catch (e) {
    print("auth error = $e");
  }
}

已完成的排查动作

  • 已在Firebase项目配置中录入应用对应的SHA-1、SHA-256证书指纹
  • 已尝试切换不同版本的firebase_auth、firebase_core依赖版本,问题复现不受依赖版本调整影响
  • 已在所有代码行设置断点调试,程序执行到_auth.verifyPhoneNumber(这一行时直接退出,无法进入后续的回调逻辑

核心崩溃日志

E/AndroidRuntime(17712): java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/browser/customtabs/CustomTabsIntent$Builder;
E/AndroidRuntime(17712):    at com.google.firebase.auth.internal.RecaptchaActivity.zza(com.google.firebase:firebase-auth@@20.0.2:13)
E/AndroidRuntime(17712):    at com.google.android.gms.internal.firebase-auth-api.zztw.zzb(com.google.firebase:firebase-auth@@20.0.2:7)
E/AndroidRuntime(17712):    at com.google.android.gms.internal.firebase-auth-api.zztw.onPostExecute(Unknown Source:2)
E/AndroidRuntime(17712):    at android.os.AsyncTask.finish(AsyncTask.java:755)
E/AndroidRuntime(17712):    at android.os.AsyncTask.access$900(AsyncTask.java:192)
E/AndroidRuntime(17712):    at android.os.AsyncTask$InternalHandler.handleMessage(AsyncTask.java:772)
E/AndroidRuntime(17712):    at android.os.Handler.dispatchMessage(Handler.java:107)
E/AndroidRuntime(17712):    at android.os.Looper.loop(Looper.java:228)
E/AndroidRuntime(17712):    at android.app.ActivityThread.main(ActivityThread.java:7826)
E/AndroidRuntime(17712):    at java.lang.reflect.Method.invoke(Native Method)
E/AndroidRuntime(17712):    at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:492)
E/AndroidRuntime(17712):    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:981)
E/AndroidRuntime(17712): Caused by: java.lang.ClassNotFoundException: Didn't find class "androidx.browser.customtabs.CustomTabsIntent$Builder" on path: DexPathList[[zip file "/data/app/com.creda.location_project-1fyv3Q9ek4vLZKMcRkGyDQ==/base.apk"],nativeLibraryDirectories=[/data/app/com.creda.location_project-1fyv3Q9ek4vLZKMcRkGyDQ==/lib/arm64, /data/app/com.creda.location_project-1fyv3Q9ek4vLZKMcRkGyDQ==/base.apk!/lib/arm64-v8a, /system/lib64, /system/product/lib64]]

问题根因

日志中明确提示类加载失败,缺少androidx.browser.customtabs.CustomTabsIntent$Builder类。Firebase Auth 20.0.2版本的手机认证流程在触发reCAPTCHA人机校验时,需要借助AndroidX Browser组件的CustomTabs能力打开验证页面,当应用未显式引入该依赖时,就会在执行到验证流程时直接触发类找不到的异常。由于异常发生在原生层的异步任务中,Dart层的try-catch无法捕获对应错误,所以表现为应用直接无提示崩溃。

解决步骤

  1. 打开Android项目级的android/app/build.gradle文件,在dependencies块中显式添加AndroidX Browser依赖:
dependencies {
    // 原有其他依赖
    implementation 'androidx.browser:browser:1.5.0'
}
  1. 检查项目的混淆规则,确保没有把androidx.browser相关类加入混淆裁剪名单,在android/app/proguard-rules.pro文件中添加保留规则:
-keep class androidx.browser.** { *; }
-dontwarn androidx.browser.**
  1. 清理构建缓存后重新打包应用:
flutter clean
flutter pub get

补充说明:如果应用已经在Firebase控制台开启了Play Integrity API校验,并且满足免验证码的认证条件,该依赖只会在需要弹出reCAPTCHA验证页时加载,不会额外增加包体运行开销。


内容的提问来源于stack exchange,提问作者prabhu r

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 08:24:07