Flutter接入Firebase时Gradle task assembleDebug失败求助

可能的原因及对应解决方法 #

1. Gradle依赖仓库配置错误（根目录build.gradle的allprojects块） #

• 检查allprojects -> repositories是否正确添加了Google Maven仓库，Firebase依赖必须从该仓库拉取：

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

• 同时确保根目录build.gradle的buildscript -> repositories也包含google()：

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
    dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2' // 匹配Flutter官方要求的版本
      classpath 'com.google.gms:google-services:4.3.15' // Firebase服务插件版本
    }
  }
  

2. App模块build.gradle配置问题 #

• 检查android -> defaultConfig里的minSdkVersion是否符合Firebase要求（至少16，部分Firebase服务要求≥21）：

  defaultConfig {
    minSdkVersion 21
    targetSdkVersion 33
    // ...其他配置项
  }
  

• 确认文件末尾是否添加了Firebase插件应用语句：

  apply plugin: 'com.google.gms.google-services'
  

• 核对Firebase依赖版本与Google服务插件版本的兼容性，避免版本不匹配。

3. Gradle缓存或同步异常 #

• 执行以下命令清理缓存并重新同步：

  flutter clean
  cd android
  ./gradlew clean
  ./gradlew build --refresh-dependencies
  cd ..
  flutter pub get
  

• 在VS Code中依次执行Flutter: Pub Get和Flutter: Refresh Flutter Projects操作，强制同步项目配置。

4. 网络问题导致依赖拉取失败 #

• 若处于国内环境，可在根目录build.gradle的repositories中添加国内镜像仓库，替代无法访问的官方仓库：

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

5. Flutter与Gradle版本不兼容 #

• 执行flutter doctor查看版本匹配提示，调整根目录gradle/wrapper/gradle-wrapper.properties中的Gradle版本：

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

  确保该版本与android/build.gradle中com.android.tools.build:gradle的版本兼容。

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