Kotlin使用Retrofit转JSON为对象时回调未触发问题排查
问题核心诱因与解决方案
1. 全链路空安全调用静默吞错
你在调用链全程使用 ?. 安全调用符,任何环节返回空值都会直接终止后续逻辑,不会抛出异常。如果 Retrofit 单例初始化失败,会依次导致 service、call 为 null,最终 call?.enqueue() 是空操作,两个回调从未被触发,完全符合你描述的“直接跳过回调、无任何输出”的表象。
最常见的初始化失败原因是 baseUrl 未以 / 结尾:旧版本 Retrofit 构建时会直接抛出 IllegalArgumentException,导致单例中的 retrofit 始终为 null。
解决方案:
- 修正 Retrofit 单例的
BASE_URL,补充结尾斜杠:private var BASE_URL = "https://api.zippopotam.us/" - 给 Retrofit 构建逻辑加异常捕获,避免静默失败:
val retrofitInstace : Retrofit? get() { if (retrofit == null) { try { retrofit = retrofit2.Retrofit.Builder() .baseUrl(BASE_URL) .addConverterFactory(GsonConverterFactory.create()) .build() } catch (e: Exception) { e.printStackTrace() } } return retrofit }
2. 网络权限缺失未被感知
未在 AndroidManifest.xml 中声明 INTERNET 权限时,系统会直接拦截请求,触发 onFailure 回调,但你使用 print 输出日志(Android Logcat 默认不显示 System.out 输出),且未打印异常堆栈,会误以为回调未执行。
解决方案:
- 补全网络权限声明:
<uses-permission android:name="android.permission.INTERNET" /> - 替换回调中的日志逻辑,使用 Android 标准
Log输出并打印完整异常:override fun onFailure(call: Call<Address>, t: Throwable) { Log.e("AddressService", "请求失败", t) } override fun onResponse(call: Call<Address>, response: Response<Address>) { if (response.isSuccessful) { _addresses.value = response.body() } else { Log.e("AddressService", "请求返回错误码:${response.code()}") } }
3. Gson 反序列化失败
你的 Location 类仅定义了带参构造,无公开无参构造函数,Gson 默认无法实例化对象。请求成功后会在解析阶段抛出异常,触发 onFailure,同样会因为日志打印不当被忽略。
解决方案:
- 给实体类补全无参构造,简化为:
class Location { @SerializedName("place name") var name: String = "" @SerializedName("longitude") var longitude: String = "" @SerializedName("state") var state: String = "" @SerializedName("state abbreviation") var stateAbbreviation: String = "" @SerializedName("latitude") var latitude: String = "" }
4. 接口写法冗余问题
你使用 @Url 传完整请求地址的写法本身没问题,但容易因 URL 拼写错误导致请求失败,且不利于维护。可直接基于 baseUrl 用路径参数拼接请求,降低出错概率。
解决方案:
- 替换原接口定义:
@GET("us/{zipCode}") fun getLocation(@Path("zipCode") zipCode: String) : Call<Address> - 调用时直接传邮编即可:
val call = service?.getLocation(zipCode)
内容的提问来源于stack exchange,提问作者Klopfstein54
相关产品推荐
相关产品推荐

