全部產品
Search

搜尋本產品

    Object Storage Service：錯誤碼

    文件中心

    Object Storage Service：錯誤碼

    更新時間：Sep 27, 2025

    訪問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碼。

    1. 訪問RecommendDoc連結

      • 直接存取錯誤響應中提供的RecommendDoc連結。

    2. 查閱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>

    相關文檔