Android Studio Chipmunk 2021.2.1 patch1新建项目构建失败如何解决

报错核心原因 #

这个报错本质是Gradle无法从配置的远程仓库拉取对应版本的Android Gradle Plugin（AGP）插件包，国内环境下90%以上的诱因是网络无法正常访问Google Maven官方仓库；旧版本项目可以正常打开，是因为对应版本的依赖已经提前缓存到本地Gradle目录，不需要重新拉取。

按优先级尝试以下解决方法： #

• 方案1：配置国内镜像源（成功率最高）
  打开项目根目录下的settings.gradle文件，在pluginManagement和dependencyResolutionManagement两个配置块的repositories列表最顶部，添加阿里云的镜像仓库地址，修改完成后的完整配置参考如下：

  pluginManagement {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/public' }
          gradlePluginPortal()
          google()
          mavenCentral()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/public' }
          google()
          mavenCentral()
      }
  }
  rootProject.name = "My Application"
  include ':app'
  

  修改完成后点击工具栏的Sync Project with Gradle Files按钮重新同步项目即可。
• 方案2：修正IDE代理配置
  镜像配置无效时检查代理设置：
  1. 打开设置路径File > Settings > Appearance & Behavior > System Settings > HTTP Proxy
  2. 不需要代理时直接选择No proxy；如果需要使用代理，确认代理地址、端口配置正确，可点击Check connection输入https://dl.google.com测试连通性
  3. 保存设置后重新同步
• 方案3：清理损坏的Gradle缓存
  历史同步失败产生的损坏缓存也会触发该错误：
  1. 完全关闭Android Studio
  2. 打开本机Gradle缓存目录，默认路径为C:\Users\你的用户名\.gradle
  3. 删除目录下的caches文件夹
  4. 重启Android Studio重新同步项目
• 方案4：关闭Gradle离线模式
  误开离线模式会导致Gradle无法拉取远程依赖：
  1. 打开设置路径File > Settings > Build, Execution, Deployment > Gradle
  2. 取消勾选Offline work选项，保存后重新同步

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