Android Retrofit - API调用返回空白正文

Android Retrofit API调用返回空白正文问题解析

基础概念

Retrofit是Square公司开发的一个类型安全的HTTP客户端库，用于Android和Java应用程序。它将HTTP API转换为Java/Kotlin接口，简化了网络请求的处理。

可能原因及解决方案

当API调用返回空白正文时，可能有以下几种原因：

1. 服务器返回了空响应

原因：服务器确实返回了空内容（HTTP 204 No Content或类似状态码） 解决方案：

// 修改返回类型为Response<Void>或Unit
@GET("endpoint")
suspend fun getData(): Response<Void>

2. 响应体解析失败

原因：响应格式与预期模型不匹配 解决方案：

检查模型类是否与JSON结构匹配
使用ResponseBody作为返回类型查看原始响应

@GET("endpoint")
suspend fun getData(): Response<ResponseBody>

// 然后可以这样获取原始字符串
val responseBody = response.body()?.string()

3. 网络拦截器问题

原因：拦截器修改或丢弃了响应体 解决方案：

检查自定义拦截器逻辑
添加日志拦截器查看原始响应

val client = OkHttpClient.Builder()
    .addInterceptor(HttpLoggingInterceptor().apply {
        level = HttpLoggingInterceptor.Level.BODY
    })
    .build()

4. 内容长度头缺失或错误

原因：服务器未正确设置Content-Length头 解决方案：

强制OkHttp处理未知长度的响应

val client = OkHttpClient.Builder()
    .addNetworkInterceptor { chain ->
        val originalResponse = chain.proceed(chain.request())
        originalResponse.newBuilder()
            .removeHeader("Transfer-Encoding")
            .removeHeader("Content-Length")
            .build()
    }
    .build()

5. 响应编码问题

原因：响应使用了非UTF-8编码 解决方案：

指定正确的字符集

val moshi = Moshi.Builder()
    .add(String::class.java, object : JsonAdapter<String>() {
        override fun fromJson(reader: JsonReader): String? {
            return reader.nextString() // 处理编码问题
        }
        // ...
    })
    .build()

6. 空响应被视为错误

原因：Retrofit将空响应视为错误 解决方案：

使用@Nullable注解

@GET("endpoint")
suspend fun getData(): @Nullable MyDataModel

调试建议

使用日志拦截器查看原始请求和响应
检查HTTP状态码
尝试使用Postman等工具直接调用API，验证服务器行为
检查API文档，确认是否确实可能返回空响应

示例完整解决方案

// 1. 添加日志拦截器
val loggingInterceptor = HttpLoggingInterceptor().apply {
    level = HttpLoggingInterceptor.Level.BODY
}

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(loggingInterceptor)
    .build()

// 2. 创建Retrofit实例
val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .client(okHttpClient)
    .addConverterFactory(MoshiConverterFactory.create())
    .build()

// 3. 定义API接口
interface ApiService {
    @GET("data")
    suspend fun getData(): Response<ResponseBody> // 使用ResponseBody获取原始响应
}

// 4. 调用API并处理响应
try {
    val response = retrofit.create(ApiService::class.java).getData()
    if (response.isSuccessful) {
        val rawResponse = response.body()?.string()
        Log.d("API_RESPONSE", "Raw response: $rawResponse")
    } else {
        Log.e("API_ERROR", "Error: ${response.code()} ${response.message()}")
    }
} catch (e: Exception) {
    Log.e("API_EXCEPTION", "Exception: ${e.message}")
}

通过以上方法，你可以逐步排查API调用返回空白正文的具体原因，并根据实际情况采取相应的解决方案。