Ionic 6构建打包后App启动闪退 GoogleSignIn类缺失报错

核心报错原因 #

java.lang.NoClassDefFoundError: com.google.android.gms.auth.api.signin.GoogleSignIn不属于插件版本冲突问题，本质是安卓构建环节缺失Google Play Services认证模块依赖：高版本@capacitor-firebase/authentication不会自动传递引入Google Sign In对应的gms依赖，反复升降级插件无法解决依赖缺失的根本问题。 #

分步修复操作 #

1. 补全安卓原生依赖 #

打开路径android/app/build.gradle，在dependencies代码块中添加缺失的依赖项：

dependencies {
    // 保留原有所有依赖配置
    // 补全Google Sign In依赖，若项目已引入Firebase BOM管控版本可省略版本号
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}

2. 校验版本配置一致性 #

• 所有@capacitor-firebase/*开头的插件必须保持大版本完全一致，且和当前项目Capacitor主版本匹配：Capacitor 4对应插件v4.x版本、Capacitor 5对应v5.x版本、Capacitor 6对应v6.x版本，禁止跨大版本混装
• 打开android/variables.gradle，确认playServicesVersion变量值不低于20.0.0，低版本gms组件未包含完整的GoogleSignIn类实现：

ext {
    // 保留原有配置，仅校验核心版本值
    playServicesVersion = "20.7.0"
    firebaseVersion = "32.2.0"
}

3. 全量清理缓存重新构建 #

配置修改后必须清理旧构建缓存，否则修改不会生效，按顺序在项目根目录执行命令：

npx cap sync android
cd android
./gradlew clean
cd ..
ionic cap build android

特殊场景排查 #

完成上述操作后仍闪退的，逐一核对以下配置：

• 检查capacitor.config.ts中authentication插件的skipNativeAuth配置项：使用原生Google登录能力时必须将该值设为false，同时确认android/app目录下已放置Firebase后台下载的、包名匹配的google-services.json文件
• 若开启了R8/ProGuard代码混淆，打开android/app/proguard-rules.pro添加保留规则，避免混淆时剔除GoogleSignIn相关类：

-keep class com.google.android.gms.auth.api.signin.** { *; }

排查提示：这类类找不到的原生报错，90%以上由依赖缺失、版本不匹配、构建缓存残留、混淆误删四个原因导致，无需盲目升降级全量插件浪费排查时间。

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