Android Studio新建项目编译失败：Gradle插件8.1.2无法找到

以下是针对该问题的具体排查和解决步骤：

1. 确认根目录settings.gradle.kts的仓库配置 #

确保项目根目录的settings.gradle.kts文件中，google()仓库在所有仓库的最前面，配置示例如下：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

仓库顺序会影响插件的查找优先级，Google仓库必须优先于其他仓库，否则可能无法获取到Android相关插件。

2. 清理本地Gradle缓存 #

本地Gradle缓存损坏可能导致插件无法正常下载，执行以下命令清理缓存：

rm -rf ~/.gradle/caches

清理完成后重启Android Studio，点击File → Sync Project with Gradle Files重新同步项目。

3. 验证Android Studio的Gradle设置 #

打开Android Studio的偏好设置：

• 路径：Android Studio → Settings → Build, Execution, Deployment → Build Tools → Gradle
• 确保Use Gradle from选项选择的是'gradle-wrapper.properties' file，而不是本地安装的Gradle版本。Gradle插件8.1.2需要搭配Gradle 8.2版本，使用wrapper能保证版本匹配。

4. 检查网络与DNS配置 #

即使关闭了工作代理，Mac的DNS解析异常也可能导致无法连接Google仓库：

• 尝试切换到公共DNS（比如8.8.8.8）：打开系统设置 → 网络 → 高级 → DNS，添加8.8.8.8并移到顶部。
• 执行ping dl.google.com测试网络连通性，确保能正常访问Google的资源服务器。

5. 检查用户级Gradle配置文件 #

查看用户目录下的Gradle配置，确认没有残留的代理或异常配置：

• 打开~/.gradle/gradle.properties，检查是否有http.proxyHost、https.proxyHost等代理相关配置，如有则注释或删除。
• 检查~/.gradle/init.gradle文件，确保没有额外的仓库或代理设置干扰。

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