build.gradle文件报错：无法解析gradle:8.1及后续问题求助

问题概述 #

构建项目时抛出异常：FAILURE: Build failed with an exception，核心错误为配置根项目android时无法解析:classpath的所有文件，找不到com.android.tools.build:gradle:8.1，已在指定仓库搜索无果。尝试升降级Gradle无效，后续仍有其他报错阻碍开发。当前环境：Gradle 8.1、OpenJDK 17.0.6。

永久解决方案 #

1. 对齐Gradle与AGP版本兼容性 #

Gradle与Android Gradle插件（AGP）存在严格版本对应关系，com.android.tools.build:gradle:8.1需搭配Gradle 8.0-8.2版本。若仓库无法拉取该版本，可切换为AGP 8.1.0（稳定版），同时确保Gradle版本匹配。

2. 重构根目录build.gradle配置 #

使用AGP 8.0+推荐的新plugins DSL写法，替换旧的buildscript块，并升级依赖版本：

plugins {
    id 'com.android.application' version '8.1.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.9.0' apply false
    id 'com.google.gms.google-services' version '4.4.0' apply false
}

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

rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(':app')
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

3. 更新app/build.gradle配置 #

调整Java编译版本与OpenJDK 17匹配，同时简化plugins写法：

plugins {
    id 'com.android.application'
    id 'kotlin-android'
    id 'com.google.gms.google-services'
}

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

android {
    namespace "com.example.food"
    compileSdkVersion flutter.compileSdkVersion
    ndkVersion flutter.ndkVersion

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }

    kotlinOptions {
        jvmTarget = '17'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        applicationId "com.example.food"
        minSdkVersion flutter.minSdkVersion
        targetSdkVersion flutter.targetSdkVersion
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    buildTypes {
        release {
            signingConfig signingConfigs.debug
        }
    }
}

flutter {
    source '../..'
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.3.1')
    implementation('com.google.firebase:firebase-analytics')
}

4. 验证gradle-wrapper.properties配置 #

确保Gradle版本与AGP兼容，若使用AGP 8.1.0，可保持Gradle 8.1或升级至8.2：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.1-all.zip

5. 清理缓存并重新构建 #

执行以下操作彻底清理缓存：

• 删除项目根目录的.gradle文件夹
• 删除android/.gradle文件夹
• 运行命令：flutter clean → flutter pub get → flutter run

关键说明 #

• 旧版buildscript块在AGP 8.0+中易出现仓库解析问题，改用新plugins DSL可避免此类错误
• Java编译版本需与JDK版本一致（OpenJDK17对应Java17），否则会引发编译冲突
• Google Services插件版本需与AGP匹配，老旧版本会导致兼容性报错

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