Retrofit中处理HTTP错误响应时获取错误信息的正确方式

在使用Retrofit进行网络请求时，开发者经常会遇到需要处理错误响应的情况。一个常见的误区是直接使用Response.message()方法来获取错误信息，但实际上这种方法并不总是有效。

HTTP状态消息与响应体的区别

Retrofit的Response类提供了message()方法，该方法返回的是HTTP协议定义的状态消息（Status Message），例如"OK"、"Not Found"等。然而，现代API设计通常不会在HTTP头中携带详细的错误信息，而是将这些信息放在响应体中。

实际问题分析

当API返回401未授权错误时，服务器可能只返回状态码而不包含状态消息。此时调用response.message()会返回空字符串，这给错误处理带来了困扰。

正确的错误信息获取方式

要获取API返回的详细错误信息，应该遵循以下步骤：

1. 检查响应是否成功：response.isSuccessful()
2. 对于不成功的响应，解析错误体：response.errorBody()
3. 将错误体转换为适当的格式（通常是JSON）

实现示例

suspend fun getRecipes(): Response<List<Recipe>> {
    try {
        val response = apiService.getRecipes("99")
        if (response.isSuccessful) {
            response.body()?.let { data ->
                if (data.recipes.isNullOrEmpty().not()) {
                    return Response.Success(data.recipes!!)
                }
            }
            return Response.Error(message = "Empty Data")
        } else {
            // 解析错误体
            val errorBody = response.errorBody()?.string()
            val errorMessage = parseErrorMessage(errorBody) ?: "请求失败"
            return Response.Error(message = errorMessage)
        }
    } catch (exception: Exception) {
        return Response.Error(message = exception.message ?: "未知错误")
    }
}

private fun parseErrorMessage(errorBody: String?): String? {
    // 实现JSON解析逻辑，提取错误信息
    // 这里可以使用Gson、Moshi等库
}

最佳实践建议

1. 统一错误处理：创建一个基础拦截器或包装类来处理所有API错误
2. 定义标准错误格式：与后端约定统一的错误响应结构
3. 提供默认错误信息：当无法解析错误体时，使用有意义的默认消息
4. 记录完整错误：在开发阶段记录完整的错误响应，便于调试

通过这种方式，开发者可以更全面地获取API返回的错误信息，为用户提供更准确的反馈，同时也便于调试和维护。