Android引入com.hbb20:ccp:2.4.5依赖报Failed to resolve错误如何解决
问题触发原因
- 项目依赖仓库配置缺失,未添加该依赖对应的远程仓库地址,或仍在使用已停止服务的JCenter仓库
- Gradle开启了离线模式,无法发起远程依赖拉取请求
- 网络受限或代理配置错误,无法正常连接依赖仓库
- 填写的依赖版本号不存在,或对应版本已被官方从仓库移除
- 本地Gradle依赖缓存损坏,导致拉取后校验失败无法正常使用
排查解决步骤
按以下顺序逐一排查即可解决:
- 核对仓库配置
如果使用的是新版Android Studio(Arctic Fox及以后版本),打开项目根目录的settings.gradle文件,找到dependencyResolutionManagement下的repositories代码块;如果是老版本Android Studio,打开根目录的build.gradle文件,找到allprojects下的repositories代码块。确保块内配置如下,注意顺序不要颠倒,删除已经失效的jcenter()配置:
google() mavenCentral() maven { url 'https://jitpack.io' }
配置完成后先同步一次Gradle,看错误是否消失。
关闭Gradle离线模式
打开Android Studio右侧边栏的Gradle面板,确认面板顶部的「Toggle Offline Mode」按钮处于未选中状态,如果被选中点击取消,再重新触发构建。更换有效依赖版本
如果仓库配置无误,大概率是填写的2.4.5版本存在异常,直接替换为当前仍在维护的稳定版本即可,把app模块build.gradle里的依赖声明替换为:
implementation 'com.hbb20:ccp:2.6.0'
替换后重新同步Gradle。
- 清理损坏的本地缓存
如果之前拉取依赖时出现过网络中断,可能导致本地缓存的依赖文件损坏,按以下步骤清理:
- 关闭Android Studio
- 进入系统用户目录下的
.gradle/caches文件夹,删除所有名称包含com.hbb20的目录 - 重新打开Android Studio,依次点击File -> Invalidate Caches...,勾选「Clear file system cache and Local History」选项后点击Invalidate and Restart
- 重启完成后重新同步项目
- 检查网络与代理配置
如果以上步骤都无效,先确认当前网络可以正常访问Maven Central、JitPack服务;如果本地使用了网络代理,在Android Studio的Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy中填写正确的代理参数,再重新尝试同步。
内容的提问来源于stack exchange,提问作者Anjali
相关产品推荐
相关产品推荐

