tencent cloud

文档反馈

异常处理

最后更新时间:2024-01-22 11:36:39

    简介

    调用 SDK 接口请求 COS 服务失败时,系统将抛出 CosXmlClientError(客户端错误)或者 CosXmlServiceError (服务端错误)。
    CosXmlClientError 是由于客户端无法和 COS 服务端正常进行交互所引起。如客户端无法连接到服务端,无法解析服务端返回的数据,读取本地文件发生 IO 错误等。
    CosXmlServiceError 是客户端和 COS 服务端交互正常,但操作 COS 资源失败。如客户端访问一个不存在 Bucket ,删除一个不存在的文件,没有权限进行某个操作等。

    客户端错误

    CosXmlClientError 例如本地文件发生 IO 错误等。CosXmlClientError 包含了定义的客户端错误码和具体的错误描述信息。捕获错误后,建议对整个错误进行打印,错误包含了必须的排查因素。以下是错误成员变量的描述:
    成员
    描述
    类型
    errorCode
    客户端错误码,如10000表示参数检验失败,更多详情请参见 SDK 错误码
    int
    message
    客户端错误信息
    string

    服务端错误

    CosXmlServiceError 例如客户端访问一个不存在 Bucket,删除一个不存在的文件,没有权限进行某个操作,服务端故障错误等。CosXmlServiceError 包含了服务端返回的状态码,requestid,出错明细等。捕获错误后,建议对整个错误进行打印,错误包含了必须的排查因素。以下是错误成员变量的描述:
    成员
    描述
    类型
    requestId
    请求 ID,用于表示一个请求,对于排查问题十分重要
    string
    statusCode
    response 的 status 状态码,4xx 是指请求因客户端而失败,5xx 是服务端异常导致的失败,更多详情请参见 COS 错误信息
    string
    errorCode
    请求失败时 body 返回的 Error Code,更多详情请参见 COS 错误信息
    string
    errorMessage
    请求失败时 body 返回的 Error Message,更多详情请参见 COS 错误信息
    string

    使用自助诊断工具

    针对请求可能遇到不同的报错情况,我们为您提供了 COS 自助诊断工具,帮助您快速定位问题,调试报错代码。

    使用步骤

    1. 复制异常处理返回的 RequestId(请求 ID)。
    2. 单击 COS 自助诊断工具,进入自助诊断页面。
    
    3. 在顶部的 RequestId 输入框中,输入待诊断的 RequestId,并单击开始诊断
    4. 稍侯片刻,便能看到相应的智能诊断结果。
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持