首次在Android Studio运行现有Android项目遇依赖解析失败求助

问题描述 #

打开现有Java/Android项目并尝试运行时，出现Gradle构建失败，核心错误为：

org.gradle.api.internal.artifacts.ivyservice.DefaultLenientConfiguration$ArtifactResolveException: 无法解析配置':app:debugCompileClasspath'的所有文件。
org.gradle.internal.resolve.ModuleVersionNotFoundException: 找不到net.cachapa.expandablelayout:expandablelayout:2.9.2。

已尝试以下操作但未解决：

• 同步项目与Gradle文件
• 清理/重建项目
• 修改Compile SDK Version、Build Tools Version、Target SDK Version至34/35/34
• 将Android Gradle Plugin从7.0.2升级到8.3.1

解决方案 #

1. 检查仓库配置 #

确保项目的仓库配置中包含Maven Central（该依赖托管在此）：

• 若使用AGP 7.0+，编辑项目根目录的settings.gradle：

  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral() // 必须添加这一行
      }
  }
  

• 若为旧版AGP，编辑根目录build.gradle：

  allprojects {
      repositories {
          google()
          mavenCentral()
      }
  }
  

2. 替换为可用的依赖版本 #

2.9.2版本可能已被归档或移除，尝试使用该库的最新稳定版本（当前为3.0.1），修改app模块的build.gradle：

implementation 'net.cachapa.expandablelayout:expandablelayout:3.0.1'

3. 清理Gradle本地缓存 #

本地缓存损坏也可能导致依赖无法解析，手动删除缓存目录后重新同步：

• Windows：删除C:\Users\<你的用户名>\.gradle\caches
• macOS/Linux：删除~/.gradle/caches
• 执行命令：./gradlew clean build --refresh-dependencies（终端中运行）

4. 排查网络/代理问题 #

若使用代理，确认代理配置允许访问Maven Central；或者暂时关闭代理，重新同步项目测试。

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