简介
调用 SDK 接口请求 COS 服务失败时,系统将抛出 CosXmlClientException(客户端异常)或者 CosXmlServiceException (服务端异常)。
CosXmlClientException 是由于客户端无法和 COS 服务端正常进行交互所引起。如客户端无法连接到服务端,无法解析服务端返回的数据,读取本地文件发生 IO 异常等。
CosXmlServiceException 是客户端和 COS 服务端交互正常,但操作 COS 资源失败。如客户端访问一个不存在 Bucket ,删除一个不存在的文件,没有权限进行某个操作等。
客户端异常
CosXmlClientException 例如本地文件发生 IO 异常等。CosXmlClientException 包含了定义的客户端错误码和具体的错误描述信息。捕获异常后,建议对整个异常进行打印,异常包含了必须的排查因素。以下是异常成员变量的描述:
|
| 客户端错误码,如10000表示参数检验失败,更多详情请参见 SDK 错误码 | |
| | |
服务端异常
CosXmlServiceException 例如客户端访问一个不存在 Bucket,删除一个不存在的文件,没有权限进行某个操作,服务端故障异常等。CosXmlServiceException 包含了服务端返回的状态码,requestid,出错明细等。捕获异常后,建议对整个异常进行打印,异常包含了必须的排查因素。以下是异常成员变量的描述:
|
| 请求 ID,用于表示一个请求,对于排查问题十分重要 | |
| response 的 status 状态码,4xx 是指请求因客户端而失败,5xx 是服务端异常导致的失败,更多详情请参见 COS 错误信息 | |
| 请求失败时 body 返回的 Error Code,更多详情请参见 COS 错误信息 | |
| 请求失败时 body 返回的 Error Message,更多详情请参见 COS 错误信息 | |
使用自助诊断工具
针对请求可能遇到不同的报错情况,我们为您提供了 COS 自助诊断工具,帮助您快速定位问题,调试报错代码。 使用步骤
1. 复制异常处理返回的 RequestId(请求 ID)。
3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断。
4. 稍侯片刻,便能看到相应的智能诊断结果。
本页内容是否解决了您的问题?