简介
调用 SDK 接口请求 COS 服务失败时，将在回调函数里返回错误信息。
错误处理示例
cos.headBucket({
Bucket: 'examplebucket-1250000000',
Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */
}, function(err, data) {
if (err) {
console.log(err.error);
}
});客户端异常
| 参数名 | 参数描述 | 类型 |
|---|---|---|
| err | 请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，详情请参见 错误码 文档 | Object |
| - error | 请求报错信息 | Object/String |
服务端异常
| 参数名 | 参数描述 | 类型 |
|---|---|---|
| err | 请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，详情请参见 错误码 文档 | Object |
| - statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
| - headers | 请求返回的头部信息 | Object |
| - error | 请求报错信息 | Object/String |
| - - Code | 请求失败时 body 返回的 Error Code，详情请参见 错误码 文档 | String |
| - - Message | 请求失败时 body 返回的 Error Message，详情请参见 错误码 文档 | String |
| - - RequestId | 服务器请求日志里的唯一 ID，可用于遇到问题 联系我们 排查错误原因 | String |
使用自助诊断工具
针对请求可能遇到不同的报错情况，我们为您提供了 COS 自助诊断工具，帮助您快速定位问题，调试报错代码。
使用步骤
- 复制异常处理返回的 RequestId（请求 ID）。
- 单击 COS 自助诊断工具，进入自助诊断页面。COS 自助诊断工具点击自助诊断输入 RequestId 进行智能诊断，获取请求基本信息、帮助指引和诊断提示，快速定位请求错误。
- 在顶部的 RequestId 输入框中，输入待诊断的 RequestId，并单击开始诊断，请您耐心等待几分钟，便能看到相应的智能诊断结果。