Android Studio无法找到AGP版本、AGP版本下拉为空问题咨询

• 触发场景：通过Android Studio升级助手执行AGP从7.0.0到目标版本的升级操作时，弹出Cannot find AGP version in build files报错
• 异常表现：打开项目结构设置页，Android Gradle Plugin Version配置项为空，对应下拉选择栏无任何可选版本
• 本地环境校验结果：C:\Users\abc\.gradle\wrapper\dists路径下存在gradle-7.3-bin包，Gradle user home已配置为C:\Users\abc\.gradle
• 异常截图：

• 直接触发原因：Android Studio升级助手启动时需要扫描项目构建文件读取当前AGP版本作为升级基准，以下几种情况会导致扫描失败：
  • 根目录build.gradle/build.gradle.kts中未直接声明AGP依赖，AGP版本被写在其他被apply的外部脚本文件中，超出升级助手的扫描范围
  • AGP版本号使用了未被IDE识别的变量声明，比如版本号定义在独立的version.gradle、gradle.properties文件中，跨文件传递变量时IDE无法静态解析到具体值
  • 之前修改构建配置时误删除了AGP的classpath声明行，导致配置项无值可读
• 下拉列表无可选版本的原因：Android Studio无法从Google Maven仓库同步可用AGP版本清单，通常是网络连通性问题导致，和本地已存储的Gradle二进制包无关——Gradle是构建工具本体，AGP是运行在Gradle上的Android构建插件，二者是独立组件，版本分开维护，本地存在Gradle安装包不代表AGP配置正常。

1. 手动修正根目录构建文件的AGP版本声明
   打开项目根目录下的build.gradle（Groovy语法）或build.gradle.kts（Kotlin DSL），在buildscript的dependencies块中直接写入明确的AGP版本号，不要使用跨文件引用的变量，参考配置如下：
   Groovy写法示例：

   buildscript {
       repositories {
           google()
           mavenCentral()
       }
       dependencies {
           // 替换为你需要升级到的目标AGP版本，注意和本地Gradle版本匹配
           classpath "com.android.tools.build:gradle:7.4.2"
       }
   }
   

   Kotlin DSL写法示例：

   buildscript {
       repositories {
           google()
           mavenCentral()
       }
       dependencies {
           classpath("com.android.tools.build:gradle:7.4.2")
       }
   }
   

2. 修复AGP版本列表同步问题
   打开Settings -> Appearance & Behavior -> System Settings -> Android SDK，勾选SDK Tools标签页下的Google Repository组件，点击应用等待同步完成；如果本地使用代理访问网络，确认Android Studio的代理配置和项目gradle.properties中的代理配置一致，可正常连通Google Maven仓库。
3. 点击工具栏的Sync Project with Gradle Files按钮触发项目同步，同步完成后重新打开项目结构设置页，AGP版本配置项即可正常显示当前版本，下拉列表也会加载所有可用版本。

该报错属于AGP升级流程的前置校验错误，不是升级操作本身损坏了项目文件。升级助手启动的第一步就是读取当前项目的AGP版本作为升级基准，读取失败就会直接抛出该错误，不会进入后续的升级步骤；修复完AGP版本声明后即可正常使用升级助手完成版本升级。

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