OSS错误码概述_对象存储(OSS)-阿里云帮助中心

访问OSS时返回的错误信息，通常包含EC码和HTTP状态码两种。遵循以下自助排查流程，可快速定位并解决问题。

自助排查流程

步骤一：定位关键信息

一次典型的错误响应包含了定位问题的核心信息。建议首先阅读Message字段获得错误的直接描述，然后按以下顺序使用关键字段进行排查，如下为错误响应示例：

HTTP/1.1 400 Bad Request
Server: AliyunOSS
Date: Thu, 11 Aug 2019 01:44:54 GMT
Content-Type: application/xml
Content-Length: 322
Connection: keep-alive
x-oss-request-id: 57ABD896CCB80C366955****
x-oss-server-time: 0
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>MissingArgument</Code>
  <Message>Missing Some Required Arguments.</Message>
  <RequestId>57ABD896CCB80C366955****</RequestId>
  <HostId>oss-example.oss-cn-hangzhou.aliyuncs.com</HostId> 
  <EC>0016-00000502</EC> 
  <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0016-00000502</RecommendDoc>
</Error>

RecommendDoc (首选方案)：官方为该EC码推荐的解决方案链接。
EC (自助排查的核心)：细粒度的错误码，唯一对应一个错误原因。
HTTP状态码 (如 400 Bad Request)：请求结果的通用状态，可用于初步判断问题方向。
RequestId (寻求支持的凭证)：请求的唯一ID，在联系技术支持时必须提供。

步骤二：获取解决方案

获取EC码后，有两种方式可用于自助排查：

重要

EC码仅用于问题定位，其值可能会发生变化，您的业务逻辑不应依赖EC码。

访问RecommendDoc链接
- 直接访问错误响应中提供的RecommendDoc链接。
查阅EC错误码列表
- 若响应中没有RecommendDoc，可根据EC码在错误码列表中查找其含义。

在完成上述自助排查步骤后，如果问题依旧存在，可准备相关信息联系技术支持。

为确保问题能被快速、精确地定位，寻求支持时必须提供本次请求的 Request ID。详细的获取方法见获取Request ID。

错误响应字段详解

错误响应头

响应头	说明
`x-oss-ec`	OSS的一种细粒度错误码。每一个错误原因对应一个唯一的EC（Error Code）。相比于响应体中的Code，EC能更加精确地反映请求出错的原因，同时也方便检索对应的解决方案。重要 EC仅用于问题定位，有可能发生变化，不保证前向兼容。因此，您的业务逻辑不应该依赖于EC错误码。
`x-oss-request-id`	请求的唯一ID。您可以凭借此Request ID联系技术支持，排查并解决您遇到的问题。

响应头示例

HTTP/1.1 403 Forbidden
Server: AliyunOSS
Date: Wed, 09 Nov 2022 08:45:46 GMT
Content-Type: application/xml
Content-Length: 471
Connection: keep-alive
x-oss-request-id: 636B68BA80DA8539399F****
x-oss-server-time: 0
x-oss-ec: 0003-00000001

关于 Content-Length，Connection 等公共响应头的更多信息，请参见公共响应头（Common Response Headers）。

错误响应体

响应元素	说明
`Code`	OSS定义的通用错误码。
`Message`	详细的错误描述信息。
`RequestId`	请求的唯一ID。您可以凭借此Request ID联系技术支持，排查并解决您遇到的问题。
`HostId`	用于标识访问的OSS集群，与用户请求时使用的Host一致。
`EC`	与响应头中的 `x-oss-ec` 一致的细粒度错误码。
`RecommendDoc`	EC对应的OpenAPI问题诊断链接。强烈建议您优先访问此链接进行自助排查。

响应体示例

<?xml version="1.0" ?>
<Error xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
  <Code>MalformedXML</Code>
  <Message>The XML you provided was not well-formed or did not validate against our published schema.</Message>
  <RequestId>57ABD896CCB80C366955****</RequestId>
  <HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
  <EC>0031-00000001</EC>
  <RecommendDoc>https://api.aliyun.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>

自助排查流程

错误响应字段详解

错误响应头

错误响应体

相关文档