Flutter项目配置Firebase失败：无法解析com.google.gms.google-services依赖

问题详情 #

构建项目时触发以下错误：

FAILURE: Build failed with an exception.

- 问题原因：
配置Android根项目 'android' 时出现问题。

> 无法解析配置 ':classpath' 的所有文件。
找不到 com.google.gms.google-services:4.3.15:。
所需依赖：
project :

BUILD FAILED in 7s
Exception: Gradle task assembleDebug failed with exit code 1

注：旧项目配置正常，当前Flutter、Android Studio均为最新版本，已按官方步骤配置Gradle文件与Firebase配置文件。

解决方案 #

1. 修正根项目Gradle依赖与仓库配置 #

打开android/build.gradle文件，调整以下内容：

buildscript {
    repositories {
        google() // 必须优先配置，确保能拉取Google官方依赖
        mavenCentral()
    }
    dependencies {
        // 确保Android Gradle插件版本与当前Android Studio兼容
        classpath 'com.android.tools.build:gradle:7.4.2'
        // 替换为兼容的google-services版本，建议升级到4.4.0及以上
        classpath 'com.google.gms:google-services:4.4.0'
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

2. 匹配Gradle版本与Android Gradle插件 #

打开android/gradle/wrapper/gradle-wrapper.properties，确保Gradle版本与插件版本兼容（示例为AGP 7.4.2对应Gradle 7.5）：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

3. 清理缓存并重新构建 #

执行以下命令清除缓存后重新构建：

flutter clean
cd android
./gradlew cleanBuildCache
cd ..
flutter pub get
flutter run

4. 验证Firebase配置文件 #

确认google-services.json已正确放置在android/app目录下，且文件内的项目ID、包名与当前Flutter项目的android/app/build.gradle中applicationId完全一致。

5. 优化仓库访问（针对网络受限环境） #

若无法正常访问Google Maven仓库，可在build.gradle的repositories块中添加国内镜像：

repositories {
    google()
    mavenCentral()
    maven { url 'https://maven.aliyun.com/repository/google' }
    maven { url 'https://maven.aliyun.com/repository/public' }
}

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