Kotlin+Retrofit+协程+MVVM架构下如何正确获取服务端API返回的错误信息

API 探路者

2026-10-7

你的问题根源是myDataResponse.message()获取的是HTTP协议自带的状态描述，并非接口响应Body中自定义的错误信息，服务端返回的错误结构存放在Response的errorBody属性中，你需要手动解析该属性拿到自定义错误内容。

实现步骤

1. 定义错误响应数据类

新增数据类匹配服务端返回的错误结构：

data class ErrorResponse(
    val message: String? = null
)

2. 新增错误体解析工具方法

使用你项目的JSON解析库（示例用Gson，可替换为Moshi等其他库），封装Response的错误体解析逻辑：

fun <T> Response<T>.parseErrorMsg(): String? {
    return try {
        val errorJson = errorBody()?.string() ?: return null
        Gson().fromJson(errorJson, ErrorResponse::class.java).message
    } catch (e: Exception) {
        // 解析失败返回null，后续兜底用HTTP默认描述
        null
    }
}

3. 修改响应处理逻辑

调整handleMyDataResponse方法中错误分支的取值逻辑：

private fun handleMyDataResponse(myDataResponse: Response<DataResponse>): HandleResource<DataResponse>? {
    if (myDataResponse.isSuccessful) {
        myDataResponse.body()?.let { myDataData ->
            return HandleResource.Success(myDataData)
        }
    }
    // 优先取服务端自定义错误信息，兜底用HTTP默认状态描述
    val errorMsg = myDataResponse.parseErrorMsg() ?: myDataResponse.message()
    return HandleResource.Error(errorMsg)
}

优化建议