深入解析skydoves/sandwich项目中ApiResponse状态码获取问题

在skydoves/sandwich这个优秀的Kotlin网络响应处理库中，开发者们经常会遇到一个典型问题：当使用ktorfit适配器时，无法正确获取HTTP响应的状态码。这个问题看似简单，却涉及到网络请求处理的核心机制。

问题本质

问题的根源在于ApiResponse.Failure.Error类型的响应处理方式。当使用ktorfit的ApiResponseConverterFactory时，系统会将响应体直接转换为文本形式作为payload，而不是保留原始的Response对象。这就导致开发者无法通过常规方式访问HTTP状态码等重要元数据。

技术背景

在标准的网络请求处理流程中，一个完整的HTTP响应应该包含三个关键部分：

1. 状态码（如200、404等）
2. 响应头
3. 响应体

skydoves/sandwich库原本设计了一套优雅的响应封装机制，能够完整保留这些信息。但当引入ktorfit适配器后，这种封装被打破了。

解决方案

仓库所有者skydoves已经确认修复了这个问题。修复后的版本应该能够正确处理以下场景：

when(val response = apiService.getData()) {
    is ApiResponse.Failure.Error -> {
        // 现在可以正确获取状态码
        val statusCode = response.statusCode
        // 处理错误逻辑
    }
    // 其他情况处理...
}

最佳实践建议

1. 版本升级：确保使用2.0.10或更高版本
2. 错误处理：在使用ApiResponse.Failure.Error时，始终检查statusCode属性
3. 响应验证：对于关键业务请求，建议同时验证状态码和响应体
4. 日志记录：在错误处理中加入状态码记录，便于问题排查

技术启示

这个问题给我们的启示是：在使用任何网络库的适配器时，都需要特别注意它是否会破坏原有的响应封装结构。特别是当混合使用多个网络库时（如ktorfit+retrofit），要仔细测试核心功能的兼容性。

skydoves/sandwich库的快速响应和修复，也体现了开源社区对问题处理的及时性，这是我们在选择技术依赖时需要考虑的重要因素之一。