執行階段錯誤目錄

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

Apigee Edge 中的錯誤

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

訊息處理器錯誤

訊息處理器是 Apigee Edge 的核心元件，會處理相關政策及 與後端伺服器互動如果偵測到任何問題，就會傳回錯誤，例如：

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

      • 或

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

訊息處理器的錯誤示例

訊息處理器一律會傳回 HTTP 狀態碼，接著會出現錯誤訊息 如下所示：

用戶端應用程式會取得回應代碼，如以下範例所示： 

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
  • 可能原因：

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

  • 該地點不存在

    • 或

  • 已存在，但尚未部署
教戰手冊

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 個標題
教戰手冊

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

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

  • 在後端/目標伺服器的 HTTP 回應標頭 Content-Encoding 有效， Apigee Edge 支援，

    • 但是

  • 後端/目標伺服器傳送做為 部分 HTTP 回應與 Content-Encoding 個標題
教戰手冊

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

教戰手冊

影片

  • 錯誤訊息：
 錯誤訊息和格式可能因後端伺服器而異 。
  • 可能原因：
 如果後端伺服器傳回狀態，就會發生這個錯誤 程式碼 500 傳送至 Apigee Edge。
  • HTTP 狀態碼：
 503

教戰手冊

影片

  • 錯誤訊息：
 錯誤訊息和格式可能因後端伺服器而異 。
  • 可能原因：
 如果後端伺服器傳回狀態，就會發生這個錯誤 程式碼 503 傳送至 Apigee Edge。
  • HTTP 狀態碼：
 504 教戰手冊
  • 錯誤訊息：
 錯誤訊息和格式可能因後端伺服器而異 。
  • 可能原因：
 如果後端伺服器傳回狀態，就會發生這個錯誤 程式碼 504 傳送至 Apigee Edge。

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

messaging.adaptors.http.flow.GatewayTimeout
  • HTTP 狀態碼：
 504 Gateway Timeout
  • 錯誤訊息：
 Gateway Timeout
  • 可能原因：
 如果後端伺服器沒有回應，就會發生這個錯誤 傳送給 Apigee 邊緣訊息處理器 訊息處理器設定的 I/O 逾時期限。
教戰手冊

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

如果 Content-Length 標頭並未傳遞 作為 HTTP POST 和 PUT 的一部分 將要求傳送至 Apigee Edge

注意：要求失敗，且 無法在追蹤工具中擷取錯誤，因為訊息處理器會執行 我們很快就會開始驗證這項驗證，接著才會處理要求 在 API Proxy 中執行任何政策。
  • HTTP 規格：
 RFC 第 3.3.2 節：Content-Length

修正

如要解決這項錯誤，請按照下列步驟操作：

  1. 確保用戶端應用程式一律傳遞標頭 Content-Length 做為 HTTP POST 的一部分 已將 PUT 項要求傳送至 Apigee Edge。例如：

    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 故障：

影片

網路連線：

影片
當後端伺服器太早關閉 連線期間，訊息處理程式仍將要求裝載傳送至 後端伺服器 教戰手冊

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

這個錯誤發生於 Apigee Edge 與 如果符合下列條件，則訊息處理器與後端伺服器：

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

      • 或

    • 不含後端伺服器的完整憑證鏈結
  2. 後端伺服器提供的憑證鏈結：
    • 包含與 在目標端點中指定的主機名稱

      • 或

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

教戰手冊

影片

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

這項錯誤會在下列任一情況發生：

  1. TargetServer未正確設定，因此無法支援 TLS/SSL 連線 。
  2. 後端伺服器可能會突然關閉連線 而 Apigee Edge 正在等待後端伺服器回應。
  3. 在 Apigee 上保留不正確的存留時間設定，以及 後端伺服器
教戰手冊

messaging.runtime.*

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

如果 Apigee Edge 無法將要求轉送至任何 目標端點的原因是：

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

    • 且

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

修正

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

  1. 檢查並修改 ProxyEndpoint 中定義的轉送規則規則，確保 沒有至少一個與要求相符的轉送規則條件。
  2. 建議您定義沒有條件的「預設」轉送規則 如果有多項 RouteRules 流量
  3. 確認預設轉送規則一律是在 條件式路徑是系統由上而下評估 ProxyEndpoint 中的規則。

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

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

修正

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

  1. 確認您已透過以下方式封鎖特定用戶端 IP 位址： 檢查在 Apigee Sense 中設定的規則。如果遭到封鎖 代表運作正常
  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
  • 可能原因：
 如果標頭名稱是做為 HTTP 元素的一部分傳送，就會發生此錯誤 向 Apigee Edge 發出的要求沒有任何內容。
  • HTTP 規格：
 RFC 7230，第 3.2 節：標頭欄位

修正

確認用戶端應用程式傳送的 HTTP 要求 Apigee Edge 一律會包含符合以下描述的有效標頭名稱： RFC 7230 的第 3.2 節：標頭欄位。

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Header {header_name} contains non ascii character {character}
  • 可能原因：
 如果 HTTP 要求中傳送標頭名稱，就會發生此錯誤 就會包含非 ASCII 字元。
  • HTTP 規格：

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

修正

確保將用戶端的 HTTP 要求傳送至 Apigee Edge 不會根據 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}
  • 可能原因：
 如果用戶端應用程式傳送的 HTTP 要求網址中的路徑，就會發生此錯誤 傳送至 Apigee Edge 的字元不符合規格規定 RFC 3986，第 3.3 節：路徑。
  • HTTP 規格：

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

修正

確認用戶端所傳送的 HTTP 要求網址中的路徑 將應用程式部署至 Apigee Edge 未包含任何 根據 RFC 3986 第 3.3 節：路徑。

protocol.http.TooBigBody
  • HTTP 狀態碼：
 413 Request Entity Too Large
  • 錯誤訊息：
 Body buffer overflow
  • 可能原因：
 如果用戶端應用程式傳送酬載大小， 傳送至 Apigee Edge 的 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}
  • 可能原因：
 如果用戶端應用程式傳送的要求行大小，就會發生這個錯誤 屬於 Apigee Edge 的 HTTP 要求超過 Apigee Edge。
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果用戶端傳送的 Content-Encoding 標頭，就會發生這個錯誤 就是 HTTP 回應包含的編碼/酬載格式， 。
  • 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}"
  • 可能原因：
 如果特定的 HTTP 標頭不允許重複，就會發生這個錯誤 會在 Apigee Edge 中多次出現，但實際上 會將後端伺服器傳送至 Apigee Edge 的 HTTP 回應
  • HTTP 規格：
 RFC 7230，第 3.2.2 節：欄位順序
教戰手冊

protocol.http.EmptyHeaderName
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Header name cannot be empty
  • 可能原因：
 如果後端伺服器在 HTTP 中傳送標頭名稱，就會發生這個錯誤 Apigee Edge 的回應沒有任何內容。
  • HTTP 規格：
 RFC 7230，第 3.2 節：標頭欄位

修正

確保後端傳送的 HTTP 回應 伺服器遷移至 Apigee Edge 時，一律會按照 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 對 Apigee 的回應 邊緣包含非 ASCII 字元。
  • HTTP 規格：

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

修正

確保將後端伺服器的 HTTP 回應傳送至 Apigee Edge 不會根據 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 節：欄位值元件

修正

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

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

在 Apigee Edge 與 經由 Proxy 伺服器存取後端伺服器，原因包括防火牆、ACL (存取控制清單)、DNS 以及後端伺服器可用性等問題

注意：錯誤訊息中的狀態碼 (faultstring) 提供問題的概略原因。
教戰手冊

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

如果後端伺服器傳回 306 狀態碼變更為 Apigee Edge。

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
  • 可能原因：
 後端伺服器會回應 不含「Allow」標頭的 405 Method Not Allowed 狀態碼。
  • 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 No Content，和 RFC 7231，6.3.6 節：205 重設內容
教戰手冊

protocol.http.TooBigBody
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Body buffer overflow
  • 可能原因：
 如果用戶端應用程式傳送酬載大小， 傳送至 Apigee Edge 的 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 中允許的上限 邊緣
  • 限制：
 Apigee Edge 限制
教戰手冊

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果 Content-Encoding 標頭是由 作為 HTTP 回應一部分的後端伺服器 非預期格式 。
  • 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}
  • 可能原因：

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

修正

確保 TargetEndpoint 或 TargetServer 中指定的 KeyAlias 並且是特定 KeyStore 的一部分。

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

如果 TargetEndpoint 或 TargetServer 不含任何憑證。

修正

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