简介
调用 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 和出错明细等。捕获异常后,建议对整个异常进行打印,异常包含了必须的排查因素。以下是异常成员变量的描述:
使用自助诊断工具
使用步骤
1. 复制异常处理返回的 RequestId(请求 ID)。
2. 单击 COS 自助诊断工具,进入自助诊断页面。
3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断,请您耐心等待几分钟,便能看到相应的智能诊断结果。