原生移动开发 / 系统课时

异常处理与统一结果模型

异常处理与统一结果模型

网络调用不应该把 HTTP 状态码、异常栈和解析错误直接泄漏给界面层。本课把成功、业务错误、网络错误和解析错误统一收敛到一个结果模型,让调用方只处理有限状态,并能稳定决定提示、重试或展示数据。

学习目标

  • 设计可区分成功、业务错误、网络错误和解析错误的统一结果类型
  • 在数据层集中完成异常到结果模型的映射
  • 让界面层只依赖稳定结果,而不是散落的 try/catch

为什么要统一结果

如果每个页面都直接捕获异常,很快会出现两类问题:同一种失败在不同页面显示不同文案,以及 HTTP 成功但业务失败的响应被误当成正常数据。更稳妥的做法是把底层细节留在数据层,对上层只暴露有限、可枚举的结果。

统一模型至少要回答四个问题:是否有可用数据、业务是否拒绝了请求、网络是否根本没有得到响应、响应是否拿到了但无法解析。

网络请求结果统一映射流程

定义稳定的结果类型

下面用 Kotlin 的 sealed interface 限定所有可能结果。业务错误保存服务端可识别的错误码;网络错误和解析错误则保留便于日志记录的原始异常。

kotlin
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 或其他客户端的挂起函数,映射原则不变。

kotlin
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}")
    }
}

预期输出

text
business=1001:登录已过期

在真实网络库中,只有明确属于“响应结构不符合约定”的异常才应归入解析错误。不要用一个宽泛的 catch (Throwable) 把取消异常、程序错误甚至系统级错误全部吞掉,否则协程取消和真正的代码缺陷都会被伪装成普通网络失败。

界面层只做状态决策

ViewModel 或界面层拿到 ApiResult 后,只需要决定展示什么,而不再关心底层是 DNS、超时、HTTP 还是 JSON 字段问题。业务错误通常展示经过确认的业务文案;网络错误可提供重试;解析错误更适合记录日志并提示数据异常。

统一结果模型真正带来的收益不是少写几个 try/catch,而是建立稳定边界:数据层负责解释失败,业务层只处理有限状态,界面层据此做一致的展示与重试决策。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

异常处理与统一结果模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通