You need to enable JavaScript to run this app. Swift API调用异步错误处理:登录接口错误方案评估与客户端处理
优惠活动
大模型
产品
解决方案
定价
更多

Swift API调用异步错误处理:登录接口错误方案评估与客户端处理

一、当前错误处理的合理性评估

先说做得对的地方:你已经有了分层定义错误的意识,把通用网络类错误和认证相关的业务错误拆成两个独立枚举,语义上比把所有错误堆在一起要清晰,后续排查问题也能快速区分是网络层还是业务逻辑的问题。

但当前实现还存在不少明显漏洞,离生产可用的标准有一定差距,主要问题如下:

  • 完全丢失了系统原生错误的上下文:原代码中只要data为空、或者error不为空,就直接返回NetworkError.noData,但实际URLSession的error可能是断网、请求超时、TLS校验失败等具体问题,现在全被模糊成"无数据",不管是排查问题还是给用户提示都没有依据。
  • 没校验HTTP状态码:哪怕接口返回401未授权、500服务端崩溃这类错误,只要有data返回,代码就会直接走JSON解码逻辑,大概率解出非预期的错误页内容,最后报错成decodingError,完全混淆了错误的根因。
  • 编码错误被静默吞掉:你用了try?处理请求体的编码,如果后续LoginRequestBody加了无法编码的字段,这里不会抛出任何错误,反而会发送空的HTTP请求体,最后得到的错误完全定位不到是编码的问题。
  • 错误分类逻辑有误:只要loginResponse.token为空就判定是invalidCredentials太草率——token为空可能是后端返回结构变更、服务端异常、甚至是你定义的LoginResponse解码模型有误,不一定是用户名密码错误。
  • 回调的错误类型不明确:两个独立的错误枚举都作为Error协议类型传出去,客户端拿到错误后还要反复做类型强转来判断来源,很容易漏处理某一类错误。
二、多来源错误的统一处理方案

解决思路分两步:先在API封装层把所有错误收敛成统一的顶层错误类型,再给客户端提供统一的处理入口。

第一步:改造错误定义,做统一错误收敛

不要把两个平行的错误枚举直接抛给客户端,而是封装一个统一的顶层错误枚举,把所有子错误作为关联值放进去,比如:

// 新增统一的API错误类型
enum APIError: Error {
    // 通用网络层错误
    case network(NetworkError)
    // 认证类业务错误
    case authentication(AuthenticationError)
    // 系统原生错误(比如断网、超时、编码失败)
    case system(Error)
}

// 可以按需给NetworkError补全场景,比如加上编码错误
enum NetworkError: Error {
    case badURL
    case noData
    case decodingError
    case encodingError // 新增,对应请求体编码失败的情况
}

同时把API方法的回调类型明确下来,不要用模糊的Error,比如登录接口的回调改成:

// 原来的回调可能是 (Result<String, Error>) -> Void,改成明确的APIError
typealias LoginCompletion = (Result<String, APIError>) -> Void

然后把原代码里的错误返回逻辑对应改造:

  • 编码请求体失败时,不要用try?吞错误,要捕获后返回APIError.network(.encodingError)
  • dataTask回调里的系统error不为空时,直接返回APIError.system(error),不要统一归为noData
  • 先把response转成HTTPURLResponse校验状态码,比如401未授权的场景再判定为凭证错误,而不是只靠token为空判断
  • 所有抛出的错误都用APIError包装,不要直接抛NetworkError或AuthenticationError

第二步:客户端侧的统一处理逻辑

因为所有错误都是明确的APIError枚举,客户端不需要做类型强转,直接用switch匹配就能统一处理,举个实际的调用例子:

login(username: inputUsername, password: inputPwd) { result in
    switch result {
    case .success(let token):
        // 存储token,跳转首页
    case .failure(let error):
        // 统一匹配错误类型
        switch error {
        case .network(let netErr):
            switch netErr {
            case .badURL: showToast("请求配置异常,请稍后重试")
            case .noData: showToast("网络无响应,请检查网络连接")
            case .decodingError, .encodingError: showToast("数据解析异常,请稍后重试")
            }
        case .authentication(let authErr):
            switch authErr {
            case .invalidCredentials: showToast("用户名或密码错误,请重新输入")
            }
        case .system(let sysErr):
            // 这里可以统一处理所有系统级错误,比如断网、超时
            showToast(sysErr.localizedDescription)
        }
    }
}

还可以更进一步,给APIError写个扩展,把所有错误对应的用户提示文案统一封装,不用每个业务接口都重复写匹配逻辑:

extension APIError {
    var userFriendlyMessage: String {
        switch self {
        case .network(let netErr):
            switch netErr {
            case .badURL: return "请求配置异常,请稍后重试"
            case .noData: return "网络无响应,请检查网络连接"
            case .decodingError, .encodingError: return "数据解析异常,请稍后重试"
            }
        case .authentication(.invalidCredentials): return "用户名或密码错误,请重新输入"
        case .system(let err): return err.localizedDescription
        }
    }
}

这样客户端只要拿到失败的错误,直接调用error.userFriendlyMessage就能弹提示,不用每个接口都写重复的错误处理代码。

后续如果新增其他业务错误(比如支付错误、订单错误),只要在APIError的枚举里加对应的case,再在userFriendlyMessage里补对应的文案就行,不会影响原有逻辑,扩展性很好。

内容的提问来源于stack exchange,提问作者Mary Doe

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 03:15:06