对象存储异常处理-SDK 文档-文档中心-腾讯云

简介
调用 SDK 接口请求 COS 服务失败时，系统将抛出 CosError，继承自 Error。
成员
描述
类型
type
错误类型（Service、Client）
CosErrorType
cosErrorCode
错误码
CosErrorCode
 错误码如下
错误码
描述
SERVICE_ERROR
服务端异常
INVALID_ARGUMENT
参数校验失败，例如必填参数为空
INVALID_CREDENTIALS
密钥信息校验失败，例如密钥获取失败
NETWORK
网络错误，请参考 鸿蒙网络错误对照﻿
TASK
任务相关异常
USER_CANCELLED
用户主动取消请求
USER_PAUSED
用户主动暂停请求
DATA_FORMAT
数据格式错误，可能为服务端响应的数据不符合实体定义等
UNKNOWN
未分类异常，业务层可以当做系统Error处理
客户端错误
CosClientError 是由于客户端无法和 COS 服务端正常进行交互所引起。如客户端无法连接到服务端，无法解析服务端返回的数据，读取本地文件发生 IO 异常等，继承自 CosError。
成员
描述
类型
detail
错误详情，可能是系统Error，也可能是字符串或者json对象
object
服务端错误
CosServiceError 是客户端和 COS 服务端交互正常，但操作 COS 资源失败。如客户端访问一个不存在 Bucket ，删除一个不存在的文件，没有权限进行某个操作， 服务端故障异常等。
成员
描述
类型
requestId
请求 ID，用于表示一个请求，对于排查问题十分重要
string
httpCode
response 的 status 状态码，4xx 是指请求因客户端而失败，5xx 是服务端异常导致的失败，更多详情请参见 COS 错误信息﻿
string
code
请求失败时 body 返回的 Error Code，更多详情请参见 COS 错误信息﻿
string
message
请求失败时 body 返回的 Error Message，更多详情请参见 COS 错误信息﻿
string
使用自助诊断工具
针对请求可能遇到不同的报错情况，我们为您提供了 COS 自助诊断工具，帮助您快速定位问题，调试报错代码。
使用步骤
1. 复制异常处理返回的 RequestId（请求 ID）。
2. 单击 COS 自助诊断工具，进入自助诊断页面。
﻿
3. 在顶部的 RequestId 输入框中，输入待诊断的 RequestId，并单击开始诊断，请您耐心等待几分钟，便能看到相应的智能诊断结果。

成员	描述	类型
type	错误类型（Service、Client）	CosErrorType
cosErrorCode	错误码	CosErrorCode

错误码	描述
SERVICE_ERROR	服务端异常
INVALID_ARGUMENT	参数校验失败，例如必填参数为空
INVALID_CREDENTIALS	密钥信息校验失败，例如密钥获取失败
NETWORK	网络错误，请参考鸿蒙网络错误对照
TASK	任务相关异常
USER_CANCELLED	用户主动取消请求
USER_PAUSED	用户主动暂停请求
DATA_FORMAT	数据格式错误，可能为服务端响应的数据不符合实体定义等
UNKNOWN	未分类异常，业务层可以当做系统Error处理

异常处理

本页目录：

简介

客户端错误

服务端错误

使用自助诊断工具

使用步骤