Firebase Auth类找不到问题求助：降级play-services-auth版本已解决求原因

问题背景 #

作为 Android Compose 新手，在使用 FirebaseUI Auth 实现邮箱/密码登录时，按官方文档配置 signInLauncher 后出现 NoClassDefFoundError，仅启用了邮箱/密码认证方式。将 com.google.android.gms:play-services-auth 从 21.0.0 降级到 20.5.0 后，错误消失，询问原因。

错误信息 #

java.lang.NoClassDefFoundError: Failed resolution of: Lcom/google/android/gms/auth/api/credentials/CredentialsOptions$Builder;at com.firebase.ui.auth.util.GoogleApiUtils.getCredentialsClient(GoogleApiUtils.java:29) 

at com.firebase.ui.auth.viewmodel.AuthViewModelBase.onCreate(AuthViewModelBase.java:30)
at com.firebase.ui.auth.viewmodel.ViewModelBase.init(ViewModelBase.java:24)
at com.firebase.ui.auth.KickoffActivity.onCreate(KickoffActivity.java:38)
at android.app.Activity.performCreate(Activity.java:8051)
at android.app.Activity.performCreate(Activity.java:8031)
at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1329)
at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3608)
at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3792)
at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:103)
at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:135)
at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:95)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2210)
at android.os.Handler.dispatchMessage(Handler.java:106)
at android.os.Looper.loopOnce(Looper.java:201)
at android.os.Looper.loop(Looper.java:288)
at android.app.ActivityThread.main(ActivityThread.java:7839)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:548)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1003)

Caused by: java.lang.ClassNotFoundException: Didn't find class "com.google.android.gms.auth.api.credentials.CredentialsOptions$Builder" on path: DexPathList[[dex file "/data/data/com.mfhc.firebasetest/code_cache/.overlay/base.apk/classes3.dex", zip file "/data/app/~~crZRGUM9m8NR4vzMFc5fFw==/com.mfhc.firebasetest-oesX28d7C_VTSFzoRDt6Gg==/base.apk"],nativeLibraryDirectories=[/data/app/~~crZRGUM9m8NR4vzMFc5fFw==/com.mfhc.firebasetest-oesX28d7C_VTSFzoRDt6Gg==/lib/x86_64, /system/lib64, /system_ext/lib64]]

dalvik.system.BaseDexClassLoader.findClass(BaseDexClassLoader.java:218)
at java.lang.ClassLoader.loadClass(ClassLoader.java:379)
at java.lang.ClassLoader.loadClass(ClassLoader.java:312)

原模块级Gradle配置 #

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.gms.google-services")
}

dependencies {
    implementation(platform("com.google.firebase:firebase-bom:32.7.3"))
    implementation("com.google.firebase:firebase-auth")
    implementation("com.firebaseui:firebase-ui-auth:8.0.2")
    implementation("com.google.android.gms:play-services-auth:21.0.0")

    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.7.0")
    implementation("androidx.activity:activity-compose:1.8.2")
    implementation(platform("androidx.compose:compose-bom:2023.08.00"))
    implementation("androidx.compose.ui:ui")
    implementation("androidx.compose.ui:ui-graphics")
    implementation("androidx.compose.ui:ui-tooling-preview")
    implementation("androidx.compose.material3:material3")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
    androidTestImplementation(platform("androidx.compose:compose-bom:2023.08.00"))
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-tooling")
    debugImplementation("androidx.compose.ui:ui-test-manifest")
}

原因分析 #

核心问题是 FirebaseUI Auth 8.0.2 与 play-services-auth 21.0.0 版本不兼容：

1. play-services-auth 21.0.0 是重大版本更新，对 Credentials API 进行了重构，直接移除了CredentialsOptions$Builder类的公开访问入口（或将其标记为内部API，不再对外暴露）。
2. FirebaseUI Auth 8.0.2 的发布时间早于 play-services-auth 21.0.0，其代码仍依赖旧版本的CredentialsOptions$Builder类构建Credentials客户端，导致运行时无法找到该类，抛出ClassNotFoundException。
3. 降级到 play-services-auth 20.5.0 时，该类仍保持公开可用状态，FirebaseUI Auth 的代码可以正常调用，因此错误消失。

后续建议 #

• 查看 FirebaseUI Auth 的官方版本兼容说明，确保引入的 play-services-auth 版本在其支持范围内。
• 如果需要使用 play-services-auth 21+ 版本，需升级 FirebaseUI Auth 到对应兼容的版本（可通过 FirebaseUI Auth 的更新日志确认哪个版本开始支持 play-services-auth 21.x）。

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