Flutter项目运行报错Could not find com.android.tools.build:gradle:4.1.0求助

根因说明 #

报错核心是项目无法拉取到Android Gradle Plugin(AGP) 4.1.0的依赖包，可按以下顺序排查修复：

• 调整仓库优先级
  打开项目android/build.gradle文件，确保google()仓库放在所有仓库的第一位，避免优先从其他仓库拉取不到对应资源，参考配置如下：

  buildscript {
      ext.kotlin_version = '1.7.10'
      repositories {
          google() // 必须放在仓库第一位
          mavenCentral()
      }
  
      dependencies {
          classpath 'com.android.tools.build:gradle:4.1.0'
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
          // Firebase相关配置，建议google-services插件版本使用4.3.15，适配AGP 4.1.0
          // classpath 'com.google.gms:google-services:4.3.15'
      }
  }
  
  allprojects {
      repositories {
          google() // 同样放在仓库第一位
          mavenCentral()
      }
  }
  

• 匹配Gradle Wrapper版本
  AGP 4.1.0要求Gradle版本最低为6.5，打开android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl对应版本符合要求，参考配置：

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

• 清理缓存重新构建
  依次执行以下操作：

  1. 执行flutter clean清理Flutter项目缓存
  2. 删除android目录下的.gradle文件夹，清理Gradle本地缓存
  3. 重新执行flutter run启动项目

• 替换国内镜像源（可选，针对网络访问受限场景）
  如果是网络原因无法访问谷歌官方仓库，可将android/build.gradle中的google()和mavenCentral()替换为阿里云镜像源：

  maven { url 'https://maven.aliyun.com/repository/google' }
  maven { url 'https://maven.aliyun.com/repository/public' }
  

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