執行階段錯誤目錄

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。info

Apigee Edge 中的錯誤

透過 Apigee Edge 提出 API 要求時，Apigee Edge 元件路由器和訊息處理器或後端伺服器可以將錯誤傳回至用戶端應用程式。

訊息處理器錯誤

訊息處理器是 Apigee Edge 的核心元件，可處理政策並與後端伺服器互動。如果偵測到任何問題，例如：

  • 網路連線問題、TLS 握手失敗、後端伺服器無法使用、與後端伺服器通訊時缺乏回應
  • 政策執行期間發生錯誤
  • 無效的 HTTP 標頭、編碼、路徑、不符合 HTTP 規格、超出產品限制等：
    • 使用用戶端應用程式傳送的 HTTP 要求

      • 或

    • 後端伺服器傳送的 HTTP 回應
  • 其他應用程式

訊息處理工具的錯誤訊息示例

訊息處理器一律會傳回 HTTP 狀態碼，接著傳回錯誤訊息和 JSON 格式的錯誤代碼，如下所示：

用戶端應用程式會取得類似下列範例的回應碼：

HTTP/1.1 414 Request-URI Too Long

訊息處理器的錯誤回應會以以下格式顯示：

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

錯誤回應中欄位的說明：

欄位 說明
faultstring 包含錯誤訊息，說明錯誤的可能原因
errorcode 與錯誤相關的錯誤代碼 (也稱為錯誤代碼)

執行階段錯誤目錄

這個錯誤目錄提供您需要瞭解的所有資訊，包括 Apigee Edge 訊息處理器元件傳回的執行階段錯誤代碼 (非政策錯誤)。其中包含每個錯誤代碼的下列資訊：

  • HTTP 狀態碼
  • 錯誤訊息
  • 導致錯誤的可能原因
  • 任何相關的 HTTP 規格和/或產品限制
  • 手冊和影片：提供如何診斷錯誤原因的操作說明，以及有效的解決方法，讓您自行解決錯誤 (如有)
  • 您可以自行套用來解決錯誤的修正項目

涵蓋以下錯誤代碼類別：

使用下方的「搜尋」方塊篩選表格，即可列出特定錯誤代碼的上述資訊。您可以在表格的任何欄位中搜尋狀態碼或任何內容。

錯誤代碼 說明 修正

flow.*

flow.APITimedOut
  • HTTP 狀態碼：
 504 Gateway Timeout
  • 錯誤訊息：
 API timed out
  • 可能原因：

發生以下狀況時會出現這個錯誤：

  • 後端伺服器不會在由 api.timeout 屬性為特定 API Proxy 設定的逾時期限內回應。
  • 政策因大量運算作業、負載過高或效能不佳而耗費大量時間。

注意：本手冊提供錯誤代碼 messaging.adaptors.http.flow.GatewayTimeout 的排解說明，但您也可以使用相同的手冊排解 flow.APITimedOut 錯誤代碼。

教戰手冊

flow.SharedFlowNotFound
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 Shared Flow {shared_flow_name} Not Found
  • 可能原因：

如果特定的共用流程，就會發生這個錯誤：

  • 該地點不存在

    • 或

  • 已存在但未部署
PLAYBOOK

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • HTTP 狀態碼：
 404 Not Found
  • 錯誤訊息：
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • 可能原因：

發生這項錯誤的情況如下：

  1. 具體的 API Proxy 如下：
    1. 未設定為接受特定虛擬主機上的要求
    2. 未設定為接受要求中使用的特定路徑
    3. 並未部署在您嘗試提出 API 要求的特定環境中
    4. 未部署在一或多個訊息處理器上
  2. 您嘗試提出 API 要求的特定環境未在一個或多個訊息處理器上載入
 教戰手冊
如果有多個虛擬主機具有相同的主機別名和通訊埠號碼，也會發生這個錯誤。 教戰手冊

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Decompression failure at request
  • 可能原因：

只有在下列情況下才會發生這個錯誤：

  • HTTP 要求標頭 Content-Encoding 中指定的編碼有效，且 Apigee Edge 支援。

    • 但是

  • 用戶端傳送的酬載格式 (做為 HTTP 要求的一部分) 與 Content-Encoding 標頭中指定的編碼格式不符
PLAYBOOK

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Decompression failure at response
  • 可能原因：

只有在下列情況下才會發生這個錯誤：

  • 後端/目標伺服器的 HTTP 回應標頭 Content-Encoding 中指定的編碼有效，且 由 Apigee Edge 支援。

    • 但

  • 後端/目標伺服器傳送的負載格式 (做為 HTTP 回應的一部分) 與 Content-Encoding 標頭中指定的編碼格式不符
PLAYBOOK

messaging.adaptors.http.flow.ErrorResponseCode
  • HTTP 狀態碼：
 500

教戰手冊

影片
  • 錯誤訊息：
 錯誤訊息和格式可能因後端伺服器實作方式而異。
  • 可能原因：
 如果後端伺服器以狀態碼 500 回應 Apigee Edge，就會發生這個錯誤。
  • HTTP 狀態碼：
 503

指南

影片

  • 錯誤訊息：
 錯誤訊息和格式可能因後端伺服器實作方式而異。
  • 可能原因：
 如果後端伺服器向 Apigee Edge 傳回狀態碼 503 的回應，就會發生這個錯誤。
  • HTTP 狀態碼：
 504 PLAYBOOK
  • 錯誤訊息：
 錯誤訊息和格式可能因後端伺服器實作方式而異。
  • 可能原因：
 如果後端伺服器向 Apigee Edge 傳回狀態碼 504 的回應，就會發生這個錯誤。

注意：錯誤代碼 messaging.adaptors.http.flow.ErrorResponseCode 不會傳回至用戶端應用程式，也不會成為傳送至用戶端應用程式的錯誤訊息的一部分。這是因為 Apigee Edge 會在後端伺服器傳回錯誤和任何 4XX 或 5XX 狀態碼時，設定這個錯誤代碼。您可以在 API 監控、NGINX 存取記錄或數據分析資料庫中查看這個錯誤代碼。

messaging.adaptors.http.flow.GatewayTimeout
  • HTTP 狀態碼：
 504 Gateway Timeout
  • 錯誤訊息：
 Gateway Timeout
  • 可能原因：
 如果後端伺服器未在 Message Processor 上設定的 I/O 逾時時間內回應 Apigee Edge Message Processor，就會發生這項錯誤。
教戰手冊

messaging.adaptors.http.flow.LengthRequired
  • HTTP 狀態碼：
 411 Length Required
  • 錯誤訊息：
 'Content-Length' is missing
  • 可能原因：

如果用戶端應用程式未將 Content-Length 標頭傳送至 Apigee Edge 的 HTTP POST 和 PUT 要求，就會發生此錯誤。

注意：由於訊息處理器會在處理要求和執行 API Proxy 中的任何政策之前，在非常早期的階段執行這項驗證，因此無法在追蹤工具中擷取發生此錯誤的失敗要求。
  • HTTP 規格：
 RFC 3.3.2 節：Content-Length

修正

如要解決這項錯誤，請執行下列步驟：

  1. 請確認用戶端應用程式一律會將標頭 Content-Length 傳送至 Apigee Edge 的 HTTP POST 和 PUT 要求。例如：

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. 即使您使用 POST 和 PUT 要求傳遞空白酬載，仍要確保傳遞標頭 Content-Length: 0。例如：

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • HTTP 狀態碼：
 503 Service Unavailable
  • 錯誤訊息：
 The Service is temporarily unavailable
  • 可能原因：

如果您在 Apigee Edge 中使用 TargetServer，就會在下列任一情況下發生此錯誤：

  1. 自訂授權伺服器在後端伺服器主機進行 DNS 解析時有誤，導致 IP 位址無效，進而導致連線錯誤。
  2. 連線逾時錯誤的原因如下：
    1. 後端伺服器上的防火牆限制會導致 Apigee Edge 無法連線至後端伺服器。
    2. Apigee Edge 和後端伺服器之間的網路連線問題。
  3. 在 TargetServer 中指定的主機名稱不正確，或含有不需要的字元 (例如空格)。

教戰手冊

影片
如果設定用於監控目標伺服器健康狀態檢查的健康狀態檢查失敗，也會發生這個錯誤。

教戰手冊

影片

messaging.adaptors.http.flow.RequestTimeOut
  • HTTP 狀態碼：
 408 Request Timeout
  • 錯誤訊息：
 Request timed out
  • 可能原因：
 如果 Apigee Edge 訊息處理器未在訊息處理器元件上設定的 I/O 逾時時間內，從用戶端應用程式收到要求酬載，就會發生此錯誤。

修正

請確認用戶端應用程式會在 Apigee Edge 的「訊息處理器」元件上設定的 I/O 逾時時間內傳送要求酬載。

messaging.adaptors.http.flow.ServiceUnavailable
  • HTTP 狀態碼：
 503 Service Unavailable
  • 錯誤訊息：
 The Service is temporarily unavailable
  • 可能原因：

發生這項錯誤的情況如下：

  1. 自訂授權伺服器對後端伺服器主機的 DNS 解析方式不正確，導致 IP 位址錯誤，進而導致連線錯誤。
  2. 連線逾時錯誤的原因如下：
    1. 後端伺服器上的防火牆限制會導致 Apigee Edge 無法連線至後端伺服器。
    2. Apigee Edge 和後端伺服器之間的網路連線問題。
  3. 目標端點中指定的目標伺服器主機不正確，或含有不需要的字元 (例如空格)。

教戰手冊

DNS 失敗：

影片

網路連線：

影片
如果後端伺服器在訊息處理工具仍將要求酬載傳送至後端伺服器時提早關閉連線，也會發生這個錯誤。 Playbook

messaging.adaptors.http.flow.SslHandshakeFailed
  • HTTP 狀態碼：
 503 Service Unavailable
  • 錯誤訊息：
 SSL Handshake failed {error_message}
  • 可能原因：

如果發生下列情況，Apigee Edge 訊息處理器與後端伺服器之間的 SSL 握手程序就會發生這個錯誤：

  1. Apigee Edge 訊息處理工具的信任存放區：
    • 含有的憑證鏈結與後端伺服器的完整憑證鏈結不符

      • 或

    • 不含後端伺服器的完整憑證鏈結
  2. 後端伺服器提供的憑證鏈結：
    • 含有與目標端點中指定的主機名稱不符的完整網域名稱 (FQDN)

      • 或

    • 含有錯誤/不完整的憑證鏈結

教戰手冊

影片

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Unexpected EOF at target
  • 可能原因：

發生這項錯誤的情況如下：

  1. TargetServer 未正確設定，無法在 Apigee Edge 中支援 TLS/SSL 連線。
  2. 當 Apigee Edge 在等待後端伺服器回應時，後端伺服器可能會突然關閉連線。
  3. 保持 Apigee 和後端伺服器的存留逾時設定不正確。
PLAYBOOK

messaging.runtime.*

messaging.runtime.RouteFailed
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 Unable to route the message to a TargetEndpoint
  • 可能原因：

如果 Apigee Edge 無法將要求轉送至任何目標端點，就會發生這個錯誤，原因如下：

  • 在 Proxy 中，沒有與要求相符的轉送規則 (<RouteRule>) 條件

    • 且

  • ProxyEndpoint 中未定義預設路徑規則 (即<RouteRule> (沒有任何條件)

修正

如要解決這項錯誤，請按照下列操作說明進行：

  1. 查看 ProxyEndpoint 中定義的路徑規則，並加以修改，確保至少有一個路徑規則條件符合您的要求。
  2. 建議您在有多個 RouteRules 時，定義沒有任何條件的預設轉送規則。
  3. 請務必在條件式路徑清單中，將預設轉送規則一律定義為最後一個，因為 ProxyEndpoint 會由上而下評估規則。

如要進一步瞭解如何在 ProxyEndpoint 中定義 <RouteRule> 條件，請參閱「 條件式目標」。

messaging.runtime.SenseRaiseFault
  • HTTP 狀態碼：
 403 Forbidden
  • 錯誤訊息：
 Sense Fault
  • 可能原因：
 如果 API 要求來自特定用戶端 IP 位址，而 Apigee Sense 規則會封鎖該位址，就會發生這個錯誤。

修正

如要解決這項錯誤，請按照下列操作說明進行：

  1. 請 檢查在 Apigee Sense 中設定的規則，確認您已封鎖特定用戶端 IP 位址。如果遭到封鎖，表示系統已正常運作。
  2. 如果特定用戶端 IP 位址並未遭到封鎖，但您仍收到這項錯誤訊息，請與 Apigee Edge 支援團隊聯絡。

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 Bad Form Data
  • 可能原因：

只有在符合下列所有條件時，才會發生這個錯誤：

  1. 用戶端傳送至 Apigee Edge 的 HTTP 要求包含：
    • Content-Type: application/x-www-form-urlencoded，以及
    • 表單資料含有百分比符號 (%)，或百分比符號 (%) 後面接著無效的十六進制字元，這類資料不符合 表單 - 第 17.13.4.1 節的規定。
  2. Apigee Edge 中的 API Proxy 會讀取特定表單參數，其中包含在要求流程中使用 ExtractVariables 或 AssignMessage 政策禁止使用的任何字元。
教戰手冊

protocol.http.DuplicateHeader
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Duplicate Header "{header_name}"
  • 可能原因：
 如果特定 HTTP 標頭無法在 Apigee Edge 中重複出現，而該標頭的值在用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求中重複出現，且值相同或不同的值，就會發生這個錯誤。
  • HTTP 規格：
 RFC 7230，第 3.2.2 節：欄位順序
指南

protocol.http.EmptyHeaderName
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Header name cannot be empty
  • 可能原因：
 如果用戶端應用程式向 Apigee Edge 傳送的 HTTP 要求中，標頭名稱為空白，就會發生此錯誤。
  • HTTP 規格：
 RFC 7230，第 3.2 節：標頭欄位

修正

請確認用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求一律包含有效的標頭名稱，符合 RFC 7230 第 3.2 節：標頭欄位的規定。

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Header {header_name} contains non ascii character {character}
  • 可能原因：
 如果用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求中包含非 ASCII 字元，就會發生這個錯誤。
  • HTTP 規格：

RFC 7230 的 3.2 節：標頭欄位和 RFC 7230 的 3.2.6 節：欄位值元件

修正

請確認傳送至 Apigee Edge 的用戶端 HTTP 要求，其標頭名稱中不含非 ASCII 字元，符合 RFC 7230 的第 3.2.6 節：欄位值元件的規定。

protocol.http.HeaderWithInvalidChar
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Header {header_name} contains invalid character {character}
  • 可能原因：
 如果用戶端應用程式透過 HTTP 要求傳送至 Apigee Edge 的標頭名稱含有無效字元，例如等號 (=)、半形逗號 (,)、分號 (;)、Tab 鍵、CRLF 和換行字元，就會發生這個錯誤。
  • HTTP 規格：

RFC 7230 的 3.2 節：標頭欄位和 RFC 7230 的 3.2.6 節：欄位值元件

修正

請確認用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求，其標頭名稱中不含任何無效字元，請參閱 RFC 7230 第 3.2.6 節：欄位值元件

protocol.http.InvalidPath
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Invalid path {path}
  • 可能原因：
 如果用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求網址中含有根據 RFC 3986 規格第 3.3 節「Path」所述不允許的字元，就會發生這個錯誤。
  • HTTP 規格：

RFC 3986，第 3 節：語法元件和 RFC 3986，第 3.3 節：路徑

修正

請確認用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求網址中，路徑不含任何不符合 RFC 3986 中 3.3 節「路徑」規定的字元。

protocol.http.TooBigBody
  • HTTP 狀態碼：
 413 Request Entity Too Large
  • 錯誤訊息：
 Body buffer overflow
  • 可能原因：
 如果用戶端應用程式傳送的酬載大小 (作為 HTTP 要求的一部分) 超過 Apigee Edge 允許的上限，就會發生這個錯誤。
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.TooBigHeaders
  • HTTP 狀態碼：
 431 Request Header Fields Too Large
  • 錯誤訊息：
 request headers size exceeding {limit}
  • 可能原因：
 用戶端應用程式傳送的所有要求標頭總大小 (做為 Apigee Edge 的 HTTP 要求一部分) 超過 Apigee Edge 允許的上限。
  • HTTP 規格：
 RFC 6585，第 5 節：431 要求標頭欄位過大
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.TooBigLine
  • HTTP 狀態碼：
 414 Request-URI Too Long
  • 錯誤訊息：
 request line size exceeding {limit}
  • 可能原因：
 如果用戶端應用程式傳送的 HTTP 要求中要求行大小超過 Apigee Edge 允許的限制，就會發生這個錯誤。
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果用戶端傳送的 Content-Encoding 標頭 (做為 HTTP 回應的一部分) 包含非 Apigee Edge 支援的編碼/酬載格式，就會發生此錯誤。
  • HTTP 規格：
 RFC 7231，6.5.13 節：415 不支援的媒體類型
教戰手冊

protocol.http.* - Caused by target

protocol.http.BadPath
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 Invalid request path
  • 可能原因：
 如果後端伺服器的請求網址 (由流程變數 target.url 代表) 包含以問號 (?) 開頭的路徑，而非正斜線 (/)，則會發生此錯誤，這會導致無效。
  • HTTP 規格：

RFC 3986，第 3 節：語法元件和 RFC 3986，第 3.3 節：路徑
教戰手冊

protocol.http.DuplicateHeader
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Duplicate Header "{header_name}"
  • 可能原因：
 如果在 Apigee Edge 中，不允許出現重複的特定 HTTP 標頭，且在後端伺服器傳送給 Apigee Edge 的 HTTP 回應中，該標頭出現了相同或不同的值，就會發生此錯誤。
  • HTTP 規格：
 RFC 7230，第 3.2.2 節：欄位順序
PLAYBOOK

protocol.http.EmptyHeaderName
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Header name cannot be empty
  • 可能原因：
 如果後端伺服器傳送的標頭名稱 (作為 HTTP 回應的一部分) 為空白，就會發生此錯誤。
  • HTTP 規格：
 RFC 7230，第 3.2 節：標頭欄位

修正

確保後端伺服器傳送至 Apigee Edge 的 HTTP 回應一律包含符合 RFC 7230 第 3.2 節：標頭欄位的有效標頭名稱。

protocol.http.EmptyPath
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 Request path cannot be empty
  • 可能原因：
 如果後端伺服器的 HTTP 要求網址 (由流程變數 target.url 表示) 包含空白路徑，就會發生這個錯誤。
  • HTTP 規格：

RFC 3986，第 3 節：語法元件 和 RFC 3986，第 3.3 節：路徑
教戰手冊

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Header {header_name} contains non ascii character {character}
  • 可能原因：
 如果後端伺服器傳送的標頭名稱 (作為 HTTP 回應的一部分) 包含非 ASCII 字元，就會發生這個錯誤。
  • HTTP 規格：

RFC 7230 的 3.2 節：標頭欄位和 RFC 7230 的 3.2.6 節：欄位值元件

修正

確認傳送至 Apigee Edge 的後端伺服器 HTTP 回應中，標頭名稱不含非 ASCII 字元，請參閱 RFC 7230，第 3.2.6 節：欄位值元件。

protocol.http.HeaderWithInvalidChar
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Header {header_name} contains invalid character {character}
  • 可能原因：
 如果後端伺服器傳送的標頭名稱 (做為 HTTP 回應的一部分) 含有無效字元，例如等號 (=)、半形逗號 (,)、分號 (;)、Tab 鍵、CRLF 和換行字元，就會發生這個錯誤。
  • HTTP 規格：

RFC 7230，第 3.2 節：標頭欄位 和 RFC 7230 第 3.2.6 節：欄位值元件

修正

依據 RFC 7230 第 3.2.6 節：欄位值元件的規定，確認傳送至 Apigee Edge 的後端伺服器 HTTP 回應中，標頭名稱中不含任何無效字元

protocol.http.ProxyTunnelCreationFailed
  • HTTP 狀態碼：
 503 Service Unavailable
  • 錯誤訊息：
 Proxy refused to create tunnel with response status {status code}
  • 可能原因：

代理伺服器在建立 Apigee Edge 與後端伺服器之間的通道時，會因防火牆、ACL (存取控制清單)、DNS 問題、後端伺服器的可用性等因素而發生這個錯誤。

注意：錯誤訊息 (faultstring) 中的狀態代碼會提供問題的大致原因。
PLAYBOOK

protocol.http.Response306Reserved
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Response Status code 306 is reserved, so can't be used.
  • 可能原因：

如果後端伺服器向 Apigee Edge 傳回 306 狀態碼，就會發生這個錯誤。

306 狀態碼是在舊版 HTTP 規格中定義。根據目前的 HTTP 規格，這個代碼是保留的，不應使用。
  • HTTP 規格：
 RFC 7231，6.3.5 節：306 保留

修正

由於狀態碼 306 已保留，請確保後端伺服器在傳送回應至 Apigee Edge 時，不會使用這個狀態碼。

protocol.http.Response405WithoutAllowHeader
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Received 405 Response without Allow Header
  • 可能原因：
 後端伺服器會以 405 Method Not Allowed 狀態碼回應，但不含「Allow」標頭。
  • HTTP 規格：

RFC 7231，第 6.5.5 節：405 方法不允許和 RFC 7231，第 7.4.1 節：允許
教戰手冊

protocol.http.ResponseWithBody
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Received {status_code} Response with message body
  • 可能原因：

如果從後端伺服器到 Apigee Edge 的 HTTP 回應為 204 No Content 或 205 Reset Content，但其中包含回應主體和/或下列一或多個標頭，就會發生這個錯誤：

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • HTTP 規格：

RFC 7231，第 6.3.5 節：204 無內容和 RFC 7231，第 6.3.6 節：205 重設內容
教戰手冊

protocol.http.TooBigBody
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Body buffer overflow
  • 可能原因：
 如果用戶端應用程式傳送的酬載大小 (作為 HTTP 要求的一部分) 超過 Apigee Edge 允許的上限，就會發生這個錯誤。
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.TooBigHeaders
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 response headers size exceeding {limit}
  • 可能原因：
 如果後端伺服器傳送的所有回應標頭總大小 (做為 Apigee Edge 的 HTTP 回應一部分) 超過 Apigee Edge 允許的上限，就會發生這個錯誤。
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.TooBigLine
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 response line size exceeding {limit}
  • 可能原因：
 如果後端伺服器傳送的回應行大小 (做為 Apigee Edge 的 HTTP 回應的一部分) 超過 Apigee Edge 允許的上限，就會發生這個錯誤。
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果後端伺服器傳送的 Content-Encoding 標頭 (做為 HTTP 回應的一部分) 包含 Apigee Edge 不支援的編碼/酬載格式，就會發生這項錯誤。
  • HTTP 規格：
 RFC 7231，第 6.5.13 節：415 不支援的媒體類型
教戰手冊

security.util.*

security.util.KeyAliasNotFound
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • 可能原因：

如果在特定 Keystore 中找不到 TargetEndpoint 或 TargetServer 中參照的特定 KeyAlias，就會發生此錯誤。

修正

請確認在 TargetEndpoint 或 TargetServer 中指定的 KeyAlias 存在，且屬於特定 Keystore。

security.util.TrustStoreWithNoCertificates
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 TrustStore {truststore_name} has no certificates
  • 可能原因：

如果 TargetEndpoint 或 TargetServer 中參照的特定 Truststore 不含任何憑證，就會發生這個錯誤。

修正

如果您想驗證後端伺服器的憑證，並且想在 TargetEndpoint 或 TargetServer 中使用 Truststore，請確保 Truststore 包含後端伺服器的有效憑證。