异常处理

最近更新时间:2023-05-23 15:44:18

我的收藏
当 SDK 请求失败的时候,返回的 error 将不为空,并且包括了错误码、错误描述和其它一些调试必备的信息,以帮助开发者快速解决问题。返回错误码(封装在返回的 error 里)主要包括两类:客户端错误和服务端错误。

客户端错误

对于设备本身因为网络原因产生的错误码,都是负数并且是四位数,例如-1001,这类错误码由苹果公司定义,可以参考 Foundation 框架中的 NSURLError.h 头文件内的定义,或者是 苹果官方文档说明
对于腾讯云 SDK 网络层本地客户端自定义错误:主要是指网络异常、证书无效、参数校验失败等,如下表所示:
错误码
错误信息
错误描述
10000
InvalidArgument
参数错误
10001
InvalidCredentials
证书无效
10004
UnsupportOperation
无法支持的操作
20001
InvalidArgument
服务器返回了不合法的数据
20004
PoorNetwork
数据完整性校验失败
30000
UserCancelled
用户取消
30002
AlreadyFinished
任务已完成

服务端错误

对于 COS 返回的错误码,是基于 HTTP 的状态码而来的,也就是404、503这类。对于这类错误码,请参见 错误码 文档寻求解决方案。您也可以使用自助诊断工具,调试报错代码,快速定位问题。

使用自助诊断工具

针对请求可能遇到不同的报错情况,我们为您提供了 COS 自助诊断工具,帮助您快速定位问题,调试报错代码。

使用步骤

1. 复制异常处理返回的 RequestId(请求 ID)
2. 单击 COS 自助诊断工具,进入自助诊断页面。

3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断,请您耐心等待几分钟,便能看到相应的智能诊断结果。