当访问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问题诊断链接。您可以单击该链接，然后进行自助排查。 |