Android Studio中com.android.application插件找不到问题求助

错误现象 #

使用Android Studio Ladybug（2024.2.1 Patch 1）运行项目时，出现以下错误：

org.gradle.api.plugins.UnknownPluginException: Plugin [id: 'com.android.application', version: '8.0.2', apply: false] was not found in any of the following sources:

- Gradle Core Plugins (plugin is not in 'org.gradle' namespace)
- Plugin Repositories (could not resolve plugin artifact 'com.android.application:com.android.application.gradle.plugin:8.0.2')
  Searched in the following repositories:

Gradle Central Plugin Repository
at Program.execute(Unknown Source)

at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.lambda$initAction$6(GradleModelFetchAction.java:184)
    at com.intellij.gradle.toolingExtension.impl.telemetry.GradleOpenTelemetry.callWithSpan(GradleOpenTelemetry.java:73)
    at com.intellij.gradle.toolingExtension.impl.telemetry.GradleOpenTelemetry.callWithSpan(GradleOpenTelemetry.java:61)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.initAction(GradleModelFetchAction.java:183)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.doExecute(GradleModelFetchAction.java:138)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.lambda$execute$1(GradleModelFetchAction.java:103)
    at com.intellij.gradle.toolingExtension.impl.telemetry.GradleOpenTelemetry.callWithSpan(GradleOpenTelemetry.java:73)
    at com.intellij.gradle.toolingExtension.impl.telemetry.GradleOpenTelemetry.callWithSpan(GradleOpenTelemetry.java:61)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.lambda$execute$2(GradleModelFetchAction.java:102)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.withOpenTelemetry(GradleModelFetchAction.java:113)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.lambda$execute$3(GradleModelFetchAction.java:101)
    at com.intellij.gradle.toolingExtension.impl.util.GradleExecutorServiceUtil.withSingleThreadExecutor(GradleExecutorServiceUtil.java:18)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.execute(GradleModelFetchAction.java:100)
    at com.intellij.gradle.toolingExtension.impl.modelAction.GradleModelFetchAction.execute(GradleModelFetchAction.java:36)

尝试升级到com.android.application:8.7.1、org.jetbrains.kotlin.android:2.0.21并运行AGP升级助手后，仍出现类似错误：

Plugin [id: 'com.android.application', version: '8.7.1', apply: false] was not found in any of the following sources:

- Gradle Core Plugins (plugin is not in 'org.gradle' namespace)
- Included Builds (No included builds contain this plugin)
- Plugin Repositories (could not resolve plugin artifact 'com.android.application:com.android.application.gradle.plugin:8.7.1')
  Searched in the following repositories:
    Gradle Central Plugin Repository

已执行过Invalidate Caches/Restart操作。

现有配置文件内容 #

项目级build.gradle.kts #

plugins {
    id("com.android.application") version "8.0.2" apply false
    id("org.jetbrains.kotlin.android") version "1.8.21" apply false
}

模块级app/build.gradle.kts #

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-kapt") // For annotation processing
}

Gradle包装器属性gradle-wrapper.properties #

distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip

settings.gradle.kts #

rootProject.name = "MyActualAppName"
include(":app")

注：项目名称非真实名称。

原因分析 #

1. 缺少插件仓库配置：Android Gradle插件（AGP）托管在Google Maven仓库，而你的settings.gradle.kts中仅配置了项目名称和模块，未指定Google仓库地址，导致Gradle只能在默认的Gradle Central仓库搜索，无法找到AGP。
2. AGP与Gradle版本不兼容（升级后问题）：AGP 8.7.1要求Gradle版本至少为8.7，而你当前使用的是Gradle 8.5，版本不匹配也会导致插件解析失败。

解决方案 #

1. 补充插件仓库配置到settings.gradle.kts #

修改settings.gradle.kts，添加pluginManagement块配置Google、MavenCentral和Gradle插件门户仓库：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

rootProject.name = "MyActualAppName"
include(":app")

2. 匹配AGP与Gradle版本 #

• 若继续使用AGP 8.0.2：当前Gradle 8.5版本兼容，无需修改gradle-wrapper.properties。
• 若升级到AGP 8.7.1：将gradle-wrapper.properties中的distributionUrl修改为Gradle 8.7或更高版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip

3. 同步并清理依赖缓存 #

• 点击Android Studio右上角的Sync Project with Gradle Files按钮完成项目同步。
• 执行命令清理缓存并重新构建：
  • macOS/Linux：./gradlew clean build --refresh-dependencies
  • Windows：gradlew.bat clean build --refresh-dependencies

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