You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 16:30:43