Flutter项目Gradle报错：无法找到com.android.tools.build:gradle:8.1.0

算力阿峰

2026-7-23

解决Flutter项目Gradle相关问题

1. 解决「无法找到com.android.tools.build:gradle:8.1.0」异常

这个问题核心是Gradle插件仓库配置缺失或版本不兼容：

先确认Flutter与Gradle的版本兼容关系：
- Flutter 3.16.x → Gradle插件8.1.0 + Gradle Wrapper 8.2
- Flutter 3.13.x/3.10.x → Gradle插件7.4.2 + Gradle Wrapper 7.5
- Flutter 3.19.x → Gradle插件8.2.0 + Gradle Wrapper 8.4
  执行flutter --version确认你的Flutter版本，再匹配对应的Gradle版本。

检查仓库配置：打开android/build.gradle，确保buildscript块里包含google()仓库（Gradle插件仅在Google仓库分发）：

buildscript {
    ext.kotlin_version = '1.9.0'
    repositories {
        google() // 必须放在mavenCentral之前
        mavenCentral()
    }
    dependencies {
        // 替换为和Flutter版本匹配的Gradle插件版本
        classpath "com.android.tools.build:gradle:8.1.0"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

同步Gradle Wrapper版本：打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为对应版本：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
```

执行清理命令（项目根目录下）：

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

2. 解决「GradleException类无法解析」高亮问题

这是Gradle版本升级后的API变更导致的语法提示问题，不影响运行但可修复：

直接替换代码中的GradleException为全限定类名org.gradle.api.GradleException，或者在文件顶部添加import：
```
import org.gradle.api.GradleException
```
若不想修改代码，在VSCode中打开命令面板（Ctrl+Shift+P），执行「Android: Sync Project with Gradle Files」，同步完成后高亮会消失。