控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

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

异常处理

最近更新时间:2021-11-18 17:19:48

简介

调用 SDK 接口请求对象存储(Cloud Object Storage,COS)服务失败时,系统将抛出 CosClientException(客户端异常)或者 CosServerException (服务端异常)。

  • CosClientException 是由于客户端无法和 COS 服务端正常进行交互所引起。例如客户端无法连接到服务端,无法解析服务端返回的数据,读取本地文件发生 IO 异常等。
  • CosServerException 是客户端和 COS 服务端交互正常,但操作 COS 资源失败。例如客户端访问一个不存在 Bucket ,删除一个不存在的文件,没有权限进行某个操作等。

客户端异常

CosClientException 集成自 System.ApplicationException,使用方法同 System.ApplicationException,同时添加一个额外的成员 errorCode,如下:

成员 描述 类型
errorCode 客户端错误码,例如10000表示参数检验失败,详情请参见 SDK 错误码 int

服务端异常

CosServerException 包含了服务端返回的状态码、requestid 和出错明细等。捕获异常后,建议对整个异常进行打印,异常包含了必须的排查因素。以下是异常成员变量的描述:

成员 描述 类型
requestId 请求 ID,用于表示一个请求,对于排查问题十分重要 string
statusCode   response 的 status 状态码,4xx 是指请求因客户端而失败,5xx 是服务端异常导致的失败,详情请参见 COS 错误码 string  
errorCode 请求失败时 body 返回的 Error Code,详情请参见 COS 错误码 string
errorMessage 请求失败时 body 返回的 Error Message,详情请参见 COS 错误码 string

使用自助诊断工具

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

使用步骤

  1. 复制异常处理返回的 RequestId(请求 ID)。
  2. 单击 COS 自助诊断工具,进入自助诊断页面。
    COS 自助诊断工具
    点击自助诊断
    输入 RequestId 进行智能诊断,获取请求基本信息、帮助指引和诊断提示,快速定位请求错误。
  3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断
  4. 稍侯片刻,便能看到相应的智能诊断结果。
目录