创建新项目时Android Studio 2021.3出现Gradle版本不兼容错误

问题分析 #

你当前使用的Gradle 7.4本应兼容Android Studio 2021.3（Chipmunk版本），错误提示里的“升级到3.0或更新”属于误判——Gradle 3.0是老旧版本，反而会和新版IDE/AGP冲突。问题大概率出在Android Gradle Plugin（AGP）与Gradle版本不匹配，或是IDE缓存异常。

具体解决步骤 #

1. 匹配AGP与Gradle版本

打开项目根目录下的build.gradle（Project级配置文件），找到dependencies块中的AGP依赖：

dependencies {
    classpath "com.android.tools.build:gradle:x.x.x" // 这里是AGP版本
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}

Android Studio 2021.3.1对应的AGP兼容范围是7.2.0~7.4.2，建议修改为：

classpath "com.android.tools.build:gradle:7.3.1"

2. 修正Gradle Wrapper配置（无需降级到3.0）

你的gradle-wrapper.properties中gradle-7.4-bin.zip是兼容版本，只需确保格式正确：

#Thu Dec 15 13:54:44 EET 2022
distributionBase=GRADLE_USER_HOME
distributionUrl=https://services.gradle.org/distributions/gradle-7.4-bin.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME

（可去掉https后的转义符\，避免部分环境下下载失败）

3. 同步Kotlin版本（适配AGP）

同样在Project级build.gradle中，确保Kotlin版本与AGP匹配：

ext {
    kotlin_version = "1.7.10" // 适配AGP 7.3.1的稳定版本
}

4. 清理IDE缓存并重启

点击菜单栏 File -> Invalidate Caches...，勾选Invalidate and Restart，等待IDE重启后重新加载项目。

执行完以上步骤后，项目应该能正常同步，你可以继续进行Kotlin开发。

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