即使这么写，还是得在每个调用 API 的地方进行 try catch 而且 Resource.Error 只包含一个 message: String 原始的 HTTP 状态码、Headers、还有具体的 Exception 类型全都丢了。

. 样板代码满天飞

每一个 API 调用都需要裹上一层 try-catch 如果你有 个接口方法，你就得写 个几乎一模一样的 try-catch 块。每一个都要捕获 HttpException 捕获 Throwable 接下来返回某种默认值。徒增维护成本与出错概率——比如在第 个方法里如果不小心忘写了某种异常捕获，程序可能直接就挂了。class UserRemoteDataSource { suspend fun fetchUser: User?{ return try { userService.fetchUser } catch { null } catch { null } } suspend fun fetchFollowers: List { return try { userService.fetchFollowers } catch { emptyList } catch { emptyList } } suspend fun updateProfile: Boolean { return try { userService.updateProfile true } catch { false } catch { false } } ... }

. 响应处理上下文丢失 Repository 和 UI 层最终拿到的只是那个“被”后的原始数据类型。它们完全接触不到 HTTP 状态码、错误响应体或者异常的细节。如果 ViewModel 需要根据不同的错误类型给使用者不同的反馈——比如 & #;提示“会话过期”，& #;其实，提示“程序维护中”——数据源就必须想方设法把这些信息硬塞进返回值里。这时通常只有三个选择：要么把异常往上抛。要么给每个 API 都定义一套复杂的 Sealed Class，要么干脆“装傻”，把这些关键信息全丢了。 你真正需要的，是一个单一的、标准化的类型。话说回来，这个类型应该能完美封装 API 调用的所有结果——不管是成功的数据、错误的细节。还是异常信息——而且能让这些信息在架构的每一层之间自由流动，不丢失任何上下文。而这正是 Sandwich 能给你的。老实说，

初识 Sandwich Sandwich 是一个 Kotlin Multiplatform 库。它的主要思想就是利用 Sealed Types 为 API 和 I/O 调用。它提供了一个非常轻量级的 ApiResponse 类型，将“成功”、“错误”和“异常”这三种情况明确地区分为不同的子类型。自带了一套丰富且可组合的 函数，让你在架构的各个层级中能干净利落地处理、转换、恢复、校验、过滤还有合并这些响应。老实说，Sandwich 完美支持 Retrofit、Ktor 和 Ktorfit。它不需要使用注解，也不涉及代码生成。不需要引入奇怪的 Gradle 插件，配置简单。

快速上手 在你的模块 build.gradle.kts 中添加依赖： dependencies { // 根据你使用的 HTTP 客户端选择对应的模块： implementation // for Retrofit implementation // for Ktor implementation // for Ktorfit }

Retrofit 使用者 只需要在建立 Retrofit 实例时添加一个 ApiResponseCallAdapterFactory : val retrofit = Retrofit.Builder .baseUrl + .addCallAdapterFactory) .addConverterFactory) .build

这个 Factory 会自动拦截所有的 Retrofit 调用，并将结果包装成 ApiResponse。它会自动处理成功的响应、HTTP 错误还有网络异常。这代表着你再也不需要手动写 try-catch

块或者自定义拦截器了。

接下来把你的 Service 接口返回值改成

ApiResponse &# x3C;T>

& # xFF1A;

interface PosterService {

@GET

-

suspend fun fetchPosterList: List &# x3C;Poster>

+

}