tencent cloud

文档反馈

异常处理

最后更新时间:2022-05-25 15:22:41

    当 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. 稍侯片刻,便能看到相应的智能诊断结果。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持