Flutter项目Firebase认证报错（build.gradle相关）求助

DevOps 小满

2026-7-13

Flutter Android项目Firebase认证相关build.gradle错误修复方案

以下是针对这类突发Gradle错误的常见修复步骤，按优先级尝试：

核对Firebase依赖版本兼容性
确认pubspec.yaml里的firebase_auth插件版本，和android/app/build.gradle中com.google.firebase:firebase-auth的版本匹配。Flutter插件通常会自动同步版本，但如果手动修改过依赖，很容易出现不兼容问题。另外com.google.gms:google-services的版本建议用稳定版，比如4.3.15。
清理Gradle缓存
运行以下命令清理缓存并刷新依赖：
```
./gradlew clean
./gradlew build --refresh-dependencies
```
也可以删除android/目录下的.gradle文件夹，之后再重新执行flutter run。
验证google-services配置文件
检查android/app/下的google-services.json是否正确，要是近期在Firebase控制台修改过项目配置，重新下载一份替换原文件。
匹配Android Gradle插件与Gradle版本
打开android/build.gradle确认com.android.tools.build:gradle的版本，再对照android/gradle/wrapper/gradle-wrapper.properties里的distributionUrl对应的Gradle版本，确保二者兼容。可以参考Android官方的版本兼容说明调整。
排查依赖冲突
执行命令查看依赖树，找出可能的冲突：
```
./gradlew app:dependencies
```
搜索firebase-auth相关条目，如果发现多个版本共存，可在android/app/build.gradle中强制统一版本：
```
configurations.all {
    resolutionStrategy.force 'com.google.firebase:firebase-auth:22.3.1'
}
```
版本号根据实际情况替换。
更新Flutter及Firebase插件
执行flutter upgrade升级到最新稳定版Flutter，再运行flutter pub upgrade更新所有依赖包，包括Firebase系列插件，新版本通常会修复已知的兼容问题。