安装Android Studio 2020.3.1后打开旧项目出现Gradle异常如何解决？

架构老林

2026-10-4

问题产生原因

核心是Android Gradle Plugin（AGP）版本与Gradle构建工具版本不兼容：新版Android Studio对可支持的AGP最低版本有明确要求，旧项目使用的AGP版本过低，无法被新版AS识别适配，是该类报错最常见的诱因。
旧项目配置的jcenter等已停止维护的仓库地址失效，部分历史依赖无法正常拉取。
项目引入的第三方Gradle插件未适配新版AGP/Gradle的API规则，出现调用冲突。

解决方法

步骤1：匹配AGP与Gradle版本

Android官方对AGP和Gradle有严格的版本对应要求，优先修改两个配置文件的版本号做适配：

打开项目根目录下的build.gradle文件，调整AGP版本号，若使用的是Android Studio Hedgehog（2023.1.1）及以上版本，建议将AGP版本至少升级到7.4+，示例配置：

plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'com.android.library' version '7.4.2' apply false
}

打开项目gradle/wrapper/gradle-wrapper.properties文件，修改Gradle发行版地址为对应匹配的版本，AGP 7.4.2对应Gradle 7.5版本，示例配置：

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

步骤2：替换失效依赖仓库

旧项目普遍使用已停止服务的jcenter仓库，建议替换为官方可用仓库，国内可添加阿里云镜像加速，修改根目录build.gradle的repositories配置：

allprojects {
    repositories {
        google()
        mavenCentral()
        // 国内用户可选添加阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
    }
}