Retrofit开发报错Cannot Resolve Symbol 'ApiClient' 求助

API 探路者

2026-5-22

解决Retrofit中"Cannot Resolve Symbol 'ApiClient'"的问题

嘿，作为刚接触Retrofit的新手，遇到这个报错太正常啦！Cannot Resolve Symbol 'ApiClient'本质上就是编译器找不到这个类，咱们一步步来排查解决：

你可能还没创建ApiClient类
其实ApiClient并不是Retrofit库自带的类，它是我们开发者自己封装的单例类，用来统一创建和管理Retrofit实例。给你一个最基础的示例代码，你可以直接参考着创建：

import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory

object ApiClient {
    // 替换成你的实际接口基础地址
    private const val BASE_URL = "https://your-api-domain.com/"

    // 懒加载创建Retrofit实例
    val retrofitInstance: Retrofit by lazy {
        Retrofit.Builder()
            .baseUrl(BASE_URL)
            // 加入Gson转换器，用来解析JSON数据
            .addConverterFactory(GsonConverterFactory.create())
            .build()
    }
}

另外别忘了在Module级的build.gradle（或build.gradle.kts）里添加Retrofit相关依赖：

dependencies {
    // Retrofit核心库
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    // Gson转换器依赖
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
}

类的包名不对或者没导入
如果你已经创建了ApiClient，先检查它所在的包路径是否正确，然后在你调用它的Activity/Fragment里，一定要导入这个类：
```
import com.your-app-package-name.ApiClient
```
要是确认路径和导入都没问题，还可以试试清理IDE缓存——点击Android Studio顶部的File -> Invalidate Caches... -> Invalidate and Restart，很多奇怪的符号找不到问题都能这么解决。
拼写或大小写错误
仔细核对你写的类名是不是ApiClient，Java/Kotlin是大小写敏感的，别把ApiClient写成APIClient或者ApiClinet这种拼写错误的版本哦。