控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

填写文档满意度调查问卷,赢取缤纷好礼> HOT

异常处理

最近更新时间:2021-11-29 14:34:32

当 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 自助诊断工具,进入自助诊断页面。
    COS 自助诊断工具
    点击自助诊断
    输入 RequestId 进行智能诊断,获取请求基本信息、帮助指引和诊断提示,快速定位请求错误。
  3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断
  4. 稍侯片刻,便能看到相应的智能诊断结果。