Android Studio无法解析:classpath配置依赖文件问题求助

问题现象 #

构建项目时提示无法解析databinding-ktx-8.7.3.aar、navigation-common、material等依赖，手动点击下载链接可正常获取文件，但Android Studio直接抛出错误，未执行自动下载流程。

已尝试无效操作 #

• 检查网络连接无异常
• 删除Gradle缓存、Android Studio缓存
• 重装Android Studio并重新下载SDK
• 修改项目SDK版本、NDK及构建工具版本
• 执行清理构建、Invalidate Cache

针对性解决方案 #

• 检查代理配置

  1. 打开项目根目录的gradle.properties文件，删除所有无关的代理配置（如http.proxyHost、https.proxyPort等），保存后同步项目。
  2. 进入Android Studio全局设置：File → Settings → Appearance & Behavior → System Settings → HTTP Proxy，确认设置为No proxy（或符合网络环境的正确代理）。

• 强制Gradle刷新依赖
  在Terminal中执行以下命令，强制Gradle忽略本地缓存重新拉取依赖：

  # macOS/Linux
  ./gradlew clean build --refresh-dependencies
  
  # Windows
  gradlew clean build --refresh-dependencies
  

• 确认仓库配置完整性
  打开Project级build.gradle文件，确保repositories块包含必要的官方仓库：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      // ...其他配置
  }
  
  allprojects {
      repositories {
          google()
          mavenCentral()
      }
  }
  

  同时检查Module级build.gradle的repositories配置是否一致。

• 手动放置依赖到本地仓库
  将手动下载的.aar/.jar文件放入Gradle本地仓库对应路径：

  • 路径格式：~/.gradle/caches/modules-2/files-2.1/[依赖组名]/[依赖名]/[版本号]/[随机哈希值]/（Windows为C:\Users\[用户名]\.gradle\caches\modules-2\files-2.1\...）
  • 若路径不存在，手动创建对应文件夹后放入文件，重新同步项目。

• 检查Gradle与AGP版本兼容性
  确保Android Gradle Plugin（AGP）版本与Gradle版本匹配（如AGP 8.7.3对应Gradle 8.8+）：

  1. 修改Project级build.gradle中的AGP版本：

     dependencies {
         classpath 'com.android.tools.build:gradle:8.7.3'
         // ...其他依赖
     }
     

  2. 修改gradle/wrapper/gradle-wrapper.properties中的Gradle版本：

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

  同步项目后重新构建。

• 排查防火墙/杀毒软件拦截
  临时关闭系统防火墙、杀毒软件或安全工具，尝试重新同步项目，确认是否存在网络请求拦截情况。

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