Flutter 3.0.2构建失败 无法解析:classpath配置所有依赖文件

错误核心表现 #

配置根项目android时抛出异常，无法解析配置:classpath下的全部依赖文件，具体缺失项为：

• com.android.tools.build:gradle:7.1.2对应的gradle-7.1.2.jar
• com.android.tools.build:builder:7.1.2对应的builder-7.1.2.jar
• com.android.tools.build:bundletool:1.8.0对应的bundletool-1.8.0.jar
  构建总耗时869ms，最终执行失败。

根因 #

默认配置下Gradle会从Google官方Maven仓库拉取Android构建相关依赖，网络连通性异常或本地缓存损坏时，就会出现依赖找不到的报错。

修复步骤 #

• 调整项目级仓库镜像配置
  打开项目路径下android/build.gradle文件，在buildscript和allprojects的repositories块中优先配置国内可正常访问的Maven镜像源，再保留原有官方仓库作为兜底，参考配置如下：

  buildscript {
      ext.kotlin_version = '1.6.10'
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/public' }
          maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:7.1.2'
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
      }
  }
  
  allprojects {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/public' }
          google()
          mavenCentral()
      }
  }
  

• 清理损坏的构建缓存
  在项目根目录终端依次执行以下操作：
  1. 执行flutter clean清理Flutter侧构建缓存
  2. 进入android目录执行./gradlew clean清理Android侧构建缓存
  3. 打开本地用户目录下的.gradle/caches路径，删除com.android.tools.build目录下对应7.1.2版本的损坏缓存文件，避免Gradle重复读取无效缓存
• 校验Gradle版本匹配性
  打开android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl指向的Gradle版本为7.4，和AGP 7.1.2版本匹配，避免版本不兼容导致的依赖解析异常。
• 重新执行构建即可。

调试参数说明 #

如果需要进一步定位问题，可在执行构建命令时追加对应参数获取更多信息：

• 追加--stacktrace参数可获取完整异常堆栈跟踪信息
• 追加--info或--debug参数可输出更详细的构建日志
• 追加--scan参数可生成完整的构建洞察分析结果

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