Flutter调试环境SHA1密钥无效，发布环境正常问题排查

安全阿岳

2026-7-7

解决Flutter项目Android Studio运行时Firebase认证失败的问题

结合你的情况，APK正常但IDE直接运行失败，核心问题大概率是debug变体的SHA1密钥不匹配，以下是具体排查和修复步骤：

重新获取正确的debug变体SHA1密钥
你当前提供的是debugAndroidTest变体的SHA1，而Android Studio直接运行的是debug变体（不是测试变体），两者密钥可能不同。执行以下命令获取正确的debug SHA1：
```
keytool -list -v -keystore C:\Users\Alula\.android\debug.keystore -alias AndroidDebugKey -storepass android -keypass android
```
（默认debug密钥库的密码、别名都是android，如果有修改请替换）
更新Firebase配置并替换google-services.json
将新获取的debug SHA1添加到Firebase控制台的对应应用设置中，重新下载google-services.json文件，覆盖android/app目录下的旧文件。
清理项目缓存与构建文件
1. 执行Flutter清理命令：
```
flutter clean
```
2. 在Android Studio中点击File -> Invalidate Caches...，勾选Invalidate and Restart，彻底清理IDE缓存。
检查build.gradle配置完整性
1. 项目根目录的build.gradle（不是app目录下的），确认dependencies块包含Google服务插件：
```
dependencies {
    // 其他依赖...
    classpath 'com.google.gms:google-services:4.4.0' // 可使用最新稳定版
}
```
2. app目录下的build.gradle，确认底部添加了Google服务插件：
```
apply plugin: 'com.google.gms.google-services'
```
验证Firebase Auth登录方式状态
登录Firebase控制台，进入Authentication -> Sign-in method，确认你使用的登录方式（比如邮箱密码、Google登录等）处于启用状态。
测试真机运行
若使用模拟器，可能存在网络代理或权限问题，切换到真机测试，排除模拟器环境干扰。