Flutter Release版App异常：Google登录失败且无法安装问题排查

一、Release APK无法安装问题排查 #

1. 签名配置错误 #

你的app/build.gradle存在两处关键问题：重复定义signingConfigs块，导致debug签名配置被覆盖；同时debug模式错误使用了release签名，这会引发安装冲突。

错误代码片段：

// 重复定义signingConfigs块，后定义的会覆盖前一个
signingConfigs {
    debug {
        keyAlias 'androiddebugkey'
        keyPassword 'android'
        storeFile file('mykey.jks')
        storePassword 'android'
    }
}

signingConfigs {
    release {
        keyAlias keystoreProperties['keyAlias']
        keyPassword keystoreProperties['keyPassword']
        storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
        storePassword keystoreProperties['storePassword']
    }
}

buildTypes {
    debug {
        signingConfig signingConfigs.release // debug模式误用release签名
    }
}

修正方案：
合并signingConfigs块，并为debug/release模式分配对应签名：

signingConfigs {
    debug {
        keyAlias 'androiddebugkey'
        keyPassword 'android'
        storeFile file('mykey.jks')
        storePassword 'android'
    }
    release {
        keyAlias keystoreProperties['keyAlias']
        keyPassword keystoreProperties['keyPassword']
        storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
        storePassword keystoreProperties['storePassword']
    }
}

buildTypes {
    debug {
        signingConfig signingConfigs.debug
    }
    release {
        signingConfig signingConfigs.release
        minifyEnabled false // 若开启混淆需额外配置规则，建议先关闭排查问题
        shrinkResources false
    }
}

2. 其他可能原因 #

• 设备已安装同名debug应用：先卸载设备上的debug版本，再安装release版
• 签名文件路径错误：检查key.properties中的storeFile路径，建议使用相对路径（如../key.jks，若jks文件在Android目录同级）
• 设备权限限制：在设备设置中开启「允许安装未知来源应用」
• APK包损坏：重新生成签名APK，确保生成过程无报错

二、Release模式Google登录失败问题排查 #

1. 确认Release签名的SHA-1已配置 #

你提供的SHA-1截图需确认是否对应release签名文件的SHA-1，而非debug签名。获取release签名SHA-1的命令：

keytool -list -v -keystore 你的release.jks文件路径 -alias 你的keyAlias

将生成的SHA-1添加到Google Cloud Console的对应Android OAuth 2.0客户端ID配置中。

2. 移除Firebase相关依赖 #

你声明使用无Firebase的Google登录，但build.gradle中引入了Firebase插件和依赖，这会干扰纯Google登录流程：

• 移除apply plugin: 'com.google.gms.google-services'
• 移除dependencies中的Firebase相关代码：

// 删除以下两行
implementation platform('com.google.firebase:firebase-bom:31.1.1')
implementation 'com.google.firebase:firebase-analytics'

3. 混淆配置（若开启混淆） #

如果release模式开启了minifyEnabled true，需在android/app/proguard-rules.pro中添加Google登录混淆规则：

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

4. 插件版本适配 #

确保pubspec.yaml中google_sign_in插件使用最新稳定版：

dependencies:
  google_sign_in: ^5.4.0 # 替换为当前最新稳定版本

三、验证步骤 #

1. 修正build.gradle签名配置，重新生成release APK
2. 确认release签名的SHA-1已添加到Google Cloud Console
3. 卸载设备上的旧应用，安装新生成的release APK
4. 测试Google登录功能

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