使用Retrofit2调用API时应用无Logcat报错直接崩溃求助

核心问题排查与修复 #

1. 接口参数类型错误（最可能触发崩溃） #

你的MemberInterface错误地将api_key当作路径参数（@Path）处理，但它本质是查询参数（@Query）。这种错误会导致URL拼接异常，直接引发请求失败甚至应用崩溃。

修正后的接口代码：

interface MemberInterface {
    @GET("")
    fun getMember(
        @Query("api_key") apiKey: String,
        @Query("numOfRows") numOfRows: Int = 5,
        @Query("pageNo") pageNo: Int = 1,
        @Query("_type") type: String = "json"
    ): Call<Member>
}

说明：

• @GET("") 适配baseUrl已包含完整端点前缀且结尾带/的场景；如果你的base_domain不包含具体端点路径，需补充对应路径（比如@GET("members")）。
• 所有URL参数通过@Query传递，这是查询参数的标准写法。

2. 强制转换空值引发崩溃 #

response.body()可能为null（比如HTTP响应码非200、解析失败等），直接用as Member强制转换会抛出NullPointerException，导致应用崩溃。

修正onResponse逻辑：

override fun onResponse(call: Call<Member>, response: Response<Member>) {
    val members = response.body()
    if (members != null) {
        var names = ""
        members.response.body.items.item.forEach { member ->
            names += "\n${member.empNm}"
        }
        binding.text.text = names
    } else {
        Toast.makeText(baseContext, "数据加载失败: 响应体为空", Toast.LENGTH_LONG).show()
    }
}

3. Gson实体类结构不匹配 #

如果Member类的字段层级与API返回的JSON结构不对应，Gson解析时会抛出异常导致崩溃。请确保实体类结构完全匹配JSON层级：
比如API返回的JSON结构大致如下：

{
  "response": {
    "body": {
      "items": {
        "item": [
          {"empNm": "张三"},
          {"empNm": "李四"}
        ]
      }
    }
  }
}

对应的Member类需包含嵌套的Response、Body、Items、Item类，字段名要与JSON键完全一致（或用@SerializedName指定映射关系）。

4. 基础配置检查 #

• BaseUrl格式：确保MemberAPI.base_domain以/结尾，比如"https://api.example.com/v1/"，Retrofit对baseUrl的格式有严格要求。
• 明文流量权限：如果API使用http协议（非https），Android 9及以上设备需在AndroidManifest.xml的application标签添加：

  android:usesCleartextTraffic="true"
  

• Logcat日志过滤：切换到No Filters查看全局日志，避免因过滤规则遗漏崩溃信息；也可通过adb logcat命令在终端查看完整日志。

额外调试建议 #

在onFailure中打印异常信息，帮助快速定位问题：

override fun onFailure(call: Call<Member>, t: Throwable) {
    t.printStackTrace()
    Toast.makeText(baseContext, "请求失败: ${t.message}", Toast.LENGTH_LONG).show()
}

内容的提问来源于stack exchange，提问作者muheonkom