无法解析配置':app:debugRuntimeClasspath'的所有依赖，急求解决方案

针对":app:debugRuntimeClasspath"依赖解析失败的深度排查方案 #

Hey there, I’ve been stuck with this exact error more times than I can count—when standard fixes don’t work, it’s time to dig into the nitty-gritty. Let’s go through some targeted steps that often resolve this stubborn issue:

• 彻底清理缓存（比AS自带的更彻底）
  光用Invalidate Caches / Restart有时候不够，手动删除这些目录再重启AS：

  • 项目根目录下的.gradle文件夹
  • 项目里的app/build和android/build文件夹（多模块项目要清理所有模块的build文件夹）
  • 本地maven仓库的损坏文件：找到~/.m2/repository（Windows路径是C:\Users\<你的用户名>\.m2\repository），删掉和报错依赖相关的文件夹，或者干脆清空整个repository目录（注意：会重新下载所有依赖，耗时较长）

• 检查代理与网络配置
  很多时候这个问题是网络或代理搞的鬼：

  • 关掉全局代理（比如VPN、系统代理），再尝试同步gradle
  • 打开AS的File > Settings > Appearance & Behavior > System Settings > HTTP Proxy，确认设置为No proxy，或者配置国内镜像仓库加速，在项目根目录的build.gradle里添加：

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

• 关闭Gradle离线模式
  有时候不小心开了离线模式，导致AS无法拉取新的依赖：
  进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle，取消勾选Offline work，点击Apply后再同步项目

• 排查依赖冲突与传递依赖问题
  用Gradle命令查看完整的依赖树，找出冲突点：
  在终端运行./gradlew app:dependencies（Windows是gradlew.bat app:dependencies），搜索报错的依赖名称，看是不是有多个版本冲突，或者某个传递依赖找不到。
  解决冲突可以用force强制指定版本，或者排除冲突的传递依赖：

  implementation('com.example:some-library:1.0.0') {
      exclude group: 'com.conflicting.group', module: 'conflicting-module'
  }
  

  也可以在gradle.properties里添加全局版本锁定：

  android.useAndroidX=true
  android.enableJetifier=true
  # 锁定依赖版本
  resolutionStrategy.force 'com.example:fixed-version:2.0.0'
  

• 检查Gradle与Android Studio版本兼容性
  即使升级了AS，也要确保Gradle wrapper版本和AS匹配：
  打开项目根目录的gradle/wrapper/gradle-wrapper.properties，查看distributionUrl里的Gradle版本，比如AS Hedgehog（2023.1.1）推荐用Gradle 8.2或更高版本，匹配不上的话改成对应的版本再同步。

• 排查项目配置文件损坏
  如果以上都没用，试试新建一个空白的Android项目，把现有代码、资源、依赖逐步迁移过去，同步每一步都检查是否报错，这样能定位是不是某个配置文件（比如build.gradle、settings.gradle）被误修改或者损坏了。

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