Retrofit2.4.0依赖已添加仍报无法解析错误如何解决?
Retrofit依赖解析失败排查方案
错误复现
构建时报错:无法为配置项
:app@debugAndroidTest/compileClasspath解析依赖:Could not resolve com.squareup.retrofit2:retrofit:2.4.0
已在模块build.gradle中添加如下依赖,仍触发报错:implementation 'com.squareup.retrofit2:retrofit:2.4.0' implementation 'com.squareup.retrofit2:converter-gson:2.4.0'
逐点排查解决
- 检查仓库源配置
打开项目根目录下的build.gradle(Android Studio Arctic Fox及以上版本对应settings.gradle),确认repositories代码块内已配置可用的依赖仓库,jcenter仓库已停止服务,仅配置jcenter会导致依赖拉取失败,基础正确配置如下:repositories { google() mavenCentral() // 使用国内镜像源时将镜像配置放在上方两个源之前即可,不要删除官方源配置 } - 校验网络与代理设置
若当前网络无法直接访问海外maven仓库,先确认Android Studio的HTTP代理配置正常,或在仓库列表中添加可用的国内maven镜像;配置完成后执行强制依赖刷新:点击Gradle面板的「Refresh All Gradle Projects」按钮,或在项目终端执行./gradlew build --refresh-dependencies命令重新拉取依赖。 - 清理损坏的本地依赖缓存
若之前拉取依赖时出现过网络中断,可能导致本地缓存的依赖文件损坏,直接进入本地Gradle缓存路径.gradle/caches/modules-2/files-2.1/com.squareup.retrofit2/,删除retrofit、converter-gson文件夹下对应2.4.0版本的目录,之后重新同步Gradle即可。 - 解决测试变体的版本冲突
报错触发路径为debugAndroidTest编译类路径,说明androidTest相关依赖可能引用了不同版本的Retrofit导致冲突,可在app模块的build.gradle中添加强制版本统一配置:android { configurations.all { resolutionStrategy { force 'com.squareup.retrofit2:retrofit:2.4.0' force 'com.squareup.retrofit2:converter-gson:2.4.0' } } }
内容的提问来源于stack exchange,提问作者Isha Narola
相关产品推荐
相关产品推荐

