原生移动开发 / 系统课时
异常处理与统一结果模型
异常处理与统一结果模型
网络调用不应该把 HTTP 状态码、异常栈和解析错误直接泄漏给界面层。本课把成功、业务错误、网络错误和解析错误统一收敛到一个结果模型,让调用方只处理有限状态,并能稳定决定提示、重试或展示数据。
学习目标
- 设计可区分成功、业务错误、网络错误和解析错误的统一结果类型
- 在数据层集中完成异常到结果模型的映射
- 让界面层只依赖稳定结果,而不是散落的
try/catch
为什么要统一结果
如果每个页面都直接捕获异常,很快会出现两类问题:同一种失败在不同页面显示不同文案,以及 HTTP 成功但业务失败的响应被误当成正常数据。更稳妥的做法是把底层细节留在数据层,对上层只暴露有限、可枚举的结果。
统一模型至少要回答四个问题:是否有可用数据、业务是否拒绝了请求、网络是否根本没有得到响应、响应是否拿到了但无法解析。

定义稳定的结果类型
下面用 Kotlin 的 sealed interface 限定所有可能结果。业务错误保存服务端可识别的错误码;网络错误和解析错误则保留便于日志记录的原始异常。
import java.io.IOException
sealed interface ApiResult<out T> {
data class Success<T>(val data: T) : ApiResult<T>
data class BusinessError(val code: Int, val message: String) : ApiResult<Nothing>
data class NetworkError(val cause: IOException) : ApiResult<Nothing>
data class ParseError(val cause: Throwable) : ApiResult<Nothing>
}
data class ApiEnvelope<T>(
val code: Int,
val message: String,
val data: T?
)这段代码只定义数据结构,不产生控制台输出。它的生效行为是:调用方在 when 中面对一组明确状态,而不是猜测异常类型或服务端字段。
在数据层集中映射异常
下面的主示例模拟一次接口调用,并把四类结果集中转换。真实项目中可以把 request() 换成 Retrofit、Ktor 或其他客户端的挂起函数,映射原则不变。
import java.io.IOException
sealed interface ApiResult<out T> {
data class Success<T>(val data: T) : ApiResult<T>
data class BusinessError(val code: Int, val message: String) : ApiResult<Nothing>
data class NetworkError(val cause: IOException) : ApiResult<Nothing>
data class ParseError(val cause: Throwable) : ApiResult<Nothing>
}
data class ApiEnvelope<T>(val code: Int, val message: String, val data: T?)
fun <T> safeCall(request: () -> ApiEnvelope<T>): ApiResult<T> {
return try {
val body = request()
if (body.code == 0 && body.data != null) {
ApiResult.Success(body.data)
} else {
ApiResult.BusinessError(body.code, body.message)
}
} catch (e: IOException) {
ApiResult.NetworkError(e)
} catch (e: IllegalArgumentException) {
// 示例中用 IllegalArgumentException 代表“响应存在但无法按约定解析”
ApiResult.ParseError(e)
}
}
fun main() {
val result = safeCall {
ApiEnvelope(code = 1001, message = "登录已过期", data = null as String?)
}
when (result) {
is ApiResult.Success -> println("data=${result.data}")
is ApiResult.BusinessError -> println("business=${result.code}:${result.message}")
is ApiResult.NetworkError -> println("network=${result.cause.message}")
is ApiResult.ParseError -> println("parse=${result.cause.message}")
}
}预期输出
business=1001:登录已过期在真实网络库中,只有明确属于“响应结构不符合约定”的异常才应归入解析错误。不要用一个宽泛的 catch (Throwable) 把取消异常、程序错误甚至系统级错误全部吞掉,否则协程取消和真正的代码缺陷都会被伪装成普通网络失败。
界面层只做状态决策
ViewModel 或界面层拿到 ApiResult 后,只需要决定展示什么,而不再关心底层是 DNS、超时、HTTP 还是 JSON 字段问题。业务错误通常展示经过确认的业务文案;网络错误可提供重试;解析错误更适合记录日志并提示数据异常。
统一结果模型真正带来的收益不是少写几个 try/catch,而是建立稳定边界:数据层负责解释失败,业务层只处理有限状态,界面层据此做一致的展示与重试决策。