You need to enable JavaScript to run this app. Kotlin使用Retrofit转JSON为对象时回调未触发问题排查
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 07:54:04