執行階段錯誤目錄

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

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

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

  • 該地點不存在

    • 或

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

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 不會包含在傳送至用戶端應用程式的錯誤訊息中。這是因為每當後端伺服器傳回錯誤以及任何 4XX 或 5XX 狀態碼時，Apigee Edge 就會設定此錯誤代碼。您可以在 API Monitoring、NGINX 存取記錄檔或數據分析資料庫中查看這個錯誤代碼。

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

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

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

注意：由於訊息處理工具是在早期階段執行這項驗證，然後才在 API Proxy 中處理要求及執行任何政策，因此追蹤記錄工具無法擷取因這項錯誤而失敗的要求。
  • HTTP 規格：
 RFC 3.3.2 節：內容長度

修正

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

  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 的訊息處理器與後端伺服器之間進行 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 和後端伺服器的即時逾時設定保持錯誤。
教戰手冊

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 時，建議您定義沒有條件的 default 轉送規則。
  3. 請確保預設轉送規則一律在條件式路徑清單中定義，因為規則會在 ProxyEndpoint 的由上而下接受評估。

如要進一步瞭解如何在 Proxy 端點中定義 <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 節：欄位值元件

修正

根據 RFC 7230 的第 3.2.6 節：欄位值元件，確保傳送至 Apigee Edge 的用戶端 HTTP 要求在標頭名稱中包含非 ASCII 字元。

protocol.http.HeaderWithInvalidChar
  • HTTP 狀態碼：
 400 Bad Request
  • 錯誤訊息：
 Header {header_name} contains invalid character {character}
  • 可能原因：
 如果用戶端應用程式傳送至 Apigee Edge 的 HTTP 要求中傳送的標頭名稱含有等號 (=)、逗號 (,)、分號 (;)、定位點、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 要求網址路徑中包含不允許的字元，就會發生這個錯誤。
  • 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
  • 可能原因：
 如果用戶端應用程式為了向 Apigee Edge 發出 HTTP 要求而傳送的酬載大小，超過 Apigee Edge 允許的限制，就會發生這個錯誤。
  • 限制：
 Apigee 邊緣限制
教戰手冊

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 邊緣限制
教戰手冊

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果用戶端做為 HTTP 回應的一部分而傳送的 Content-Encoding 標頭包含 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}"
  • 可能原因：
 如果特定 HTTP 標頭不得在 Apigee Edge 中重複，且在後端伺服器傳送至 Apigee Edge 的 HTTP 回應中，出現相同的或不同的值重複，就會發生這個錯誤。
  • HTTP 規格：
 RFC 7230 第 3.2.2 節：欄位順序
教戰手冊

protocol.http.EmptyHeaderName
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Header name cannot be empty
  • 可能原因：
 如果後端伺服器在對 Apigee Edge 的 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}
  • 可能原因：
 如果後端伺服器在對 Apigee Edge 的 HTTP 回應中傳送的標頭名稱含有非 ASCII 字元，就會發生這個錯誤。
  • HTTP 規格：

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

修正

根據 RFC 7230 的第 3.2.6 節：欄位值元件，確保傳送至 Apigee Edge 的後端伺服器的 HTTP 回應不含非 ASCII 字元。

protocol.http.HeaderWithInvalidChar
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Header {header_name} contains invalid character {character}
  • 可能原因：
 如果後端伺服器傳送的標頭名稱包含在 HTTP 回應中，且含有等號 (=)、逗號 (,)、分號 (;)、定位點、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}
  • 可能原因：

Proxy 伺服器在 Apigee Edge 和後端伺服器之間建立通道時，會因防火牆、ACL (存取控制清單 (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
  • 可能原因：
 後端伺服器以 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
  • 可能原因：
 如果用戶端應用程式為了向 Apigee Edge 發出 HTTP 要求而傳送的酬載大小，超過 Apigee Edge 允許的限制，就會發生這個錯誤。
  • 限制：
 Apigee 邊緣限制
教戰手冊

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 邊緣限制
教戰手冊

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果後端伺服器作為 HTTP 回應的一部分而傳送的 Content-Encoding 標頭包含 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 包含後端伺服器的有效憑證。