Android Studio构建失败：com.android.application插件未找到

错误详情 #

构建失败并抛出异常：
位置：构建文件 C:\Users\richard\StudioProjects\bb\android\app\build.gradle 第2行
问题原因：未在以下任何来源中找到插件 [id: 'com.android.application']：

• Gradle核心插件（该插件不在 org.gradle 命名空间下）
• 插件仓库（此来源的插件依赖必须包含版本号）
  异常：Gradle任务 assembleDebug 因退出码1失败，构建于5秒内完成失败

修复步骤 #

• 配置仓库与插件依赖：在项目根目录的 build.gradle 文件中，确保添加Google和Maven仓库，并声明Android Gradle插件的classpath：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:7.4.2' // 可替换为当前稳定版本
      }
  }
  

• 正确声明插件：在app模块的 build.gradle 文件中，按以下方式之一声明插件：
  1. 直接指定版本号：

     plugins {
         id 'com.android.application' version '7.4.2'
     }
     

  2. 使用版本目录统一管理（推荐）：
     在 settings.gradle 中配置插件仓库与版本：

     pluginManagement {
         repositories {
             google()
             mavenCentral()
             gradlePluginPortal()
         }
         plugins {
             id 'com.android.application' version '7.4.2'
         }
     }
     

     之后在app模块的 build.gradle 中即可简化声明：

     plugins {
         id 'com.android.application'
     }
     

调试手段 #

• 执行构建时添加 --stacktrace 参数，获取完整堆栈跟踪以定位深层问题
• 使用 --info 或 --debug 参数，输出更详细的构建日志
• 添加 --scan 参数，生成完整的构建分析报告

内容的提问来源于stack exchange，提问作者Albert Tetteh Adjei