创建首个Gradle项目时Gradle同步失败求助

• 检查仓库配置
  确认项目根目录的build.gradle（或settings.gradle的pluginManagement块）中已添加Google和MavenCentral仓库，这是获取Android官方依赖的必要来源：
  根build.gradle示例：

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

  settings.gradle示例：

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

• 清理Gradle缓存
  手动删除本地Gradle缓存目录，强制重新下载依赖：

  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • Mac/Linux：~/.gradle/caches
    删除整个caches文件夹后，回到Android Studio点击"Sync Project with Gradle Files"重新同步。

• 验证AGP与Gradle版本匹配
  AGP 8.2.2对应的Gradle版本应为8.3，检查gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-bin.zip
  

  版本不匹配会导致依赖解析失败，确保两者对应（AGP 8.2.x系列对应Gradle 8.3）。

• 排查网络与代理问题

  • 若使用代理，检查代理配置是否正确（路径：File > Settings > Build, Execution, Deployment > Build Tools > Gradle），尝试关闭代理后重新同步。
  • 若无法直接访问Google仓库，可在settings.gradle中配置国内镜像仓库：

    pluginManagement {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/public' }
            gradlePluginPortal()
        }
    }
    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' }
        }
    }
    

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