OSS错误码概述 - 对象存储 OSS

当访问OSS出现错误时，OSS会返回Code、Message、RequestId、EC等信息，方便您定位并解决问题。

错误响应头

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

以下错误响应头说明如下：

响应头

说明

x-oss-ec

OSS的一种细粒度错误码。每一个错误原因对应一个唯一的EC（Error Code）。相比于错误响应体XML中的Code，EC能更加精确地反映请求出错的原因，同时也方便检索对应的解决方案。如果某个请求出现错误，EC会出现在该请求对应的HTTP响应中的响应头（x-oss-ec）和响应体XML中（/Error/EC）。您可以通过EC精确查找错误原因和解决方法。

重要

EC仅用于问题定位，有可能发生变化，不保证前向兼容。因此，您的业务逻辑不应该依赖于EC错误码。

关于错误响应头中包含的Content-Length，Connection，x-oss-request-id等公共响应头的更多信息，请参见公共响应头（Common Response Headers）。

错误响应体

<?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>

以上错误响应体包含的响应元素说明如下：

响应元素	说明
Code	错误响应体返回的错误码。
Message	错误响应体返回的详细错误消息。
RequestId	用于唯一标识该次请求的UUID。您可以凭借此Request ID联系技术支持，排查并解决您遇到的问题。
HostId	用于标识访问的OSS集群，与用户请求时使用的Host一致。
EC	OSS的一种细粒度错误码。每一个错误原因对应一个唯一的EC（Error Code）。相比于错误响应体XML中的Code，EC能更加精确地反映请求出错的原因，同时也方便检索对应的解决方案。如果某个请求出现错误，EC会出现在该请求对应的HTTP响应中的响应头（x-oss-ec）和响应体XML中（/Error/EC）。您可以通过EC精确查找错误原因和解决方法。重要 EC仅用于问题定位，有可能发生变化，不保证前向兼容。因此，您的业务逻辑不应该依赖于EC错误码。
RecommendDoc	EC对应的OpenAPI问题诊断链接。您可以单击该链接，然后进行自助排查。

对象存储 OSS：错误码

错误响应头

错误响应体

相关文档