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无法捕获对应错误,所以表现为应用直接无提示崩溃。
解决步骤
- 打开Android项目级的
android/app/build.gradle文件,在dependencies块中显式添加AndroidX Browser依赖:
dependencies { // 原有其他依赖 implementation 'androidx.browser:browser:1.5.0' }
- 检查项目的混淆规则,确保没有把
androidx.browser相关类加入混淆裁剪名单,在android/app/proguard-rules.pro文件中添加保留规则:
-keep class androidx.browser.** { *; } -dontwarn androidx.browser.**
- 清理构建缓存后重新打包应用:
flutter clean flutter pub get
补充说明:如果应用已经在Firebase控制台开启了Play Integrity API校验,并且满足免验证码的认证条件,该依赖只会在需要弹出reCAPTCHA验证页时加载,不会额外增加包体运行开销。
内容的提问来源于stack exchange,提问作者prabhu r
相关产品推荐
相关产品推荐

