新建Material 3 Compose项目遇com.android.tools.build:gradle:7.4.0匹配失败问题

错误核心原因 #

• Android Gradle Plugin (AGP) 7.4.0要求运行环境为Java 11，但当前项目默认配置了Java 8，导致版本不兼容
• AGP版本与Gradle插件API版本（7.5）的匹配要求未满足

分步解决方案 #

1. 切换项目Java版本到11 #

修改项目根目录的build.gradle（或build.gradle.kts）：

Groovy语法：

plugins {
    id 'com.android.application' version '7.4.0' apply false
    id 'com.android.library' version '7.4.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.7.20' apply false
}

java {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
}

Kotlin DSL语法：

plugins {
    id("com.android.application") version "7.4.0" apply false
    id("com.android.library") version "7.4.0" apply false
    id("org.jetbrains.kotlin.android") version "1.7.20" apply false
}

java {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
}

接着修改模块目录（如app）的build.gradle（或build.gradle.kts）：

Groovy语法：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_11
        targetCompatibility JavaVersion.VERSION_11
    }

    kotlinOptions {
        jvmTarget = '11'
    }
}

Kotlin DSL语法：

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }

    kotlinOptions {
        jvmTarget = "11"
    }
}

2. 验证Gradle版本匹配 #

打开gradle/wrapper/gradle-wrapper.properties，确保distributionUrl指向Gradle 7.5：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

3. 同步项目 #

点击Android Studio右上角的「Sync Project with Gradle Files」按钮，等待同步完成即可。

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