Flutter初始项目运行失败：无法解析Android构建依赖

云原生阿岚

2026-8-5

问题排查与解决步骤

1. 检查Android SDK组件完整性

打开Android SDK管理面板（VS Code可通过侧边栏的Android插件入口进入），确认以下组件已安装：
- SDK Platforms：安装与Flutter 3.3.10兼容的Android版本（推荐API 31及以上）
- SDK Tools：确保Android SDK Build-Tools（需包含报错中提到的7.1.2对应兼容版本）、Android SDK Command-line Tools、Gradle相关组件已完整安装
若有缺失，点击安装并等待下载完成

2. 修复Gradle依赖拉取问题

打开项目根目录下的android/build.gradle文件，核对buildscript块的依赖配置：

buildscript {
  ext.kotlin_version = '1.6.10'
  repositories {
      google()
      mavenCentral()
  }
  dependencies {
      classpath "com.android.tools.build:gradle:7.1.2"
      classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
  }
}

若网络无法访问官方仓库，可替换为国内镜像源，修改repositories部分：

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' }
}

执行命令行指令flutter clean清理项目缓存，之后重新尝试运行项目

3. 匹配Gradle版本与插件版本

查看android/gradle/wrapper/gradle-wrapper.properties中的Gradle分发版本，确保与com.android.tools.build:gradle版本兼容（7.1.2版本的插件对应Gradle 7.2左右的分发包）：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-all.zip
```
若本地无对应Gradle版本，可手动下载后放入用户目录/.gradle/wrapper/dists文件夹，或等待Gradle自动下载（需保证网络通畅）