控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

异常处理

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

简介

调用 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 自助诊断工具,帮助您快速定位问题,调试报错代码。

使用步骤

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