Android Studio创建空项目时Gradle依赖包找不到问题求助

环境信息 #

Android Studio Iguana | 2023.2.1 Patch 1
Build #AI-232.10300.40.2321.11567975, built on March 13, 2024
Runtime version: 17.0.9+0--11185874 amd64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
Windows 11.0
GC: G1 Young Generation, G1 Old Generation
Memory: 4050M
Cores: 16
Registry:
    ide.experimental.ui=true

错误信息 #

A problem occurred configuring root project 'My Application'.
> Could not resolve all files for configuration ':classpath'.
   > Could not find gradle-8.3.1.jar (com.android.tools.build:gradle:8.3.1).
     Searched in the following locations:
         https://dl.google.com/dl/android/maven2/com/android/tools/build/gradle/8.3.1/gradle-8.3.1.jar
   > Could not find gradle-settings-api-8.3.1.jar (com.android.tools.build:gradle-settings-api:8.3.1).
     Searched in the following locations:
         https://dl.google.com/dl/android/maven2/com/android/tools/build/gradle-settings-api/8.3.1/gradle-settings-api-8.3.1.jar
   > Could not find lint-model-31.3.1.jar (com.android.tools.lint:lint-model:31.3.1).
     Searched in the following locations:
         https://dl.google.com/dl/android/maven2/com/android/tools/lint/lint-model/31.3.1/lint-model-31.3.1.jar
   > Could not find builder-8.3.1.jar (com.android.tools.build:builder:8.3.1).
     Searched in the following locations:
         https://dl.google.com/dl/android/maven2/com/android/tools/build/builder/8.3.1/builder-8.3.1.jar

解决步骤 #

• 检查网络连通性：尝试访问错误日志中给出的依赖包URL，确认网络是否能正常连接Google Maven仓库。如果无法访问，检查代理设置或切换到可访问该仓库的网络环境。
• 添加国内Maven镜像：修改项目根目录下的build.gradle文件，在buildscript和allprojects的repositories中添加国内镜像仓库，示例如下：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:8.3.1"
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
}

• 清理并重启Android Studio：点击菜单栏File -> Invalidate Caches...，选择Invalidate and Restart，清除本地Gradle缓存后重新同步项目。
• 手动放置依赖包：如果上述方法无效，可手动下载对应依赖包，放入本地Gradle缓存目录（Windows路径一般为C:\Users\[你的用户名]\.gradle\caches\modules-2\files-2.1），对应包名和版本的文件夹下，之后重新同步项目。
• 验证Gradle版本兼容性：确认Android Studio Iguana推荐的Gradle版本是否为8.3.1，若版本不匹配，可尝试调整build.gradle中的Gradle版本号为官方推荐的对应版本，再同步项目。

内容的提问来源于stack exchange，提问作者S.M_Emamian