在Gradle中添加依赖库时出现':app:debugRuntimeClasspath'解析失败错误

问题详情 #

用户遇到依赖库相关报错，相同库在其他项目可正常运行，相关信息如下：

错误截图 #

Gradle依赖配置截图 #

错误与我添加的库相关，但相同库在其他项目中可正常运行。

添加的依赖项 #

• implementation 'com.thoughtbot:expandablerecyclerview:1.4'
• implementation 'com.romandanylyk:pageindicatorview:X.X.X'

解决步骤 #

1. 替换版本占位符
   com.romandanylyk:pageindicatorview:X.X.X中的X.X.X是无效占位符，需替换为具体版本号（如最新稳定版1.0.3），Gradle无法识别占位符会直接导致依赖拉取失败。

2. 清理并重建项目

• 点击File > Sync Project with Gradle Files同步配置
• 执行Build > Clean Project后再执行Build > Rebuild Project，清除缓存的无效依赖文件。

3. 核对Gradle版本兼容性
   对比正常项目的Gradle插件、AGP版本，确认当前项目版本与依赖库兼容。例如expandablerecyclerview:1.4基于旧版Android Support库，若当前项目使用AndroidX，需确保gradle.properties中启用Jetifier兼容：

android.useAndroidX=true
android.enableJetifier=true

4. 检查仓库配置
   确认根目录settings.gradle中配置了必要仓库：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

缺少仓库会导致Gradle无法下载目标依赖。

5. 排查依赖冲突
   执行命令查看依赖树：

# macOS/Linux
./gradlew app:dependencies

# Windows
gradlew.bat app:dependencies

若发现冲突依赖，通过exclude排除冲突模块，例如：

implementation('com.thoughtbot:expandablerecyclerview:1.4') {
    exclude group: 'com.android.support'
}

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