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
相关产品推荐
相关产品推荐

