執行階段錯誤目錄

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

Apigee 中的錯誤

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

訊息處理工具的錯誤

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

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

      • 或

    • 後端伺服器傳送 HTTP 回應
  • 還有許多其他功能

訊息處理工具的錯誤範例

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

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

  HTTP/1.1 504 Gateway Timeout

訊息處理器的錯誤回應格式如下： 

{
  "fault": {
    "faultstring": "Gateway Timeout",
    "detail": {
      "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
      "reason": "TARGET_READ_TIMEOUT"
    }
  }
}

錯誤回應中的欄位說明：

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

執行階段錯誤目錄

這個錯誤目錄提供所有必要資訊，協助您瞭解 Apigee Message Processor 元件傳回的執行階段錯誤代碼 (適用於非政策錯誤)。這份報表會針對每個錯誤代碼列出下列資訊：

  • HTTP 狀態碼
  • 錯誤訊息
  • 錯誤原因 (並非所有錯誤訊息都會顯示 reason)
  • 錯誤的可能原因
  • 任何相關的 HTTP 規格和/或產品限制
  • 應對手冊和影片，內含錯誤原因診斷說明，以及可自行套用的有效解決方法 (如有)
  • 修正方式，可自行解決錯誤

涵蓋的錯誤代碼類別如下：

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

錯誤代碼 說明 修正

flow.*

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

發生這個錯誤的可能原因如下：

  • 後端伺服器未在屬性 api.timeout 為特定 API Proxy 設定的逾時期間內回覆。
  • 由於需要大量運算作業、負載過高或效能不佳，導致政策執行時間過長。

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

如果特定共用流程有下列情況，就會發生這個錯誤：

  • 該地點不存在

    • 或

  • 存在但未部署

messaging.adaptors.http.flow

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

CLIENT_READ_CONTENT_NOT_IN_GZIP_FORMAT
  • 可能原因：

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

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

    • BUT

  • 用戶端在 HTTP 要求中傳送的酬載格式，與 Content-Encoding 標頭中指定的編碼格式不符

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

TARGET_READ_CONTENT_NOT_IN_GZIP_FORMAT

TARGET_READ_INCORRECT_HEADER_CHECK
  • 可能原因：

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

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

    • BUT

  • 後端/目標伺服器傳送的 HTTP 回應負載格式，與 Content-Encoding 標頭中指定的編碼格式不符

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

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

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

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

messaging.adaptors.http.flow.InternalServerError
  • HTTP 狀態碼：
 500 Internal Server Error
  • 錯誤訊息：
 Internal server error at backend
  • 原因：
 SERVER_ERROR
  • 可能原因：
 發生這個錯誤的原因如下：
  1. 後端應用程式在處理 Apigee 的要求時，發生未處理的例外狀況或錯誤。這可能是因為應用程式程式碼中的邏輯有誤、輸入內容超出預期，或是發生其他執行階段問題。
  2. 後端伺服器可能無法連線至資料庫，或是資料庫查詢可能失敗。這可能是因為網路連線、資料庫憑證有誤、資料庫伺服器停機，或是資料庫結構定義或資料有問題。
  3. 如果後端伺服器依賴其他內部或外部服務 (例如 API、訊息佇列或快取系統)，其中一項依附元件發生故障，可能會導致伺服器向 Apigee 回傳 500 錯誤。後端可能無法與依附服務通訊，或可能收到依附服務傳回的錯誤回應。
  4. 後端伺服器可能因流量過高、記憶體 (RAM) 不足、CPU 使用率過高或磁碟空間不足而過載。如果伺服器資源不足，就無法處理要求，並會傳回 500 錯誤。
  5. 後端伺服器設定不正確，可能會在處理要求時導致未預期的錯誤。包括伺服器設定、應用程式設定或部署設定的問題。
  6. 後端應用程式程式碼可能存在基本錯誤，而 Apigee 的特定要求會觸發這項錯誤。這些錯誤在正常情況下可能不會顯現，但會因特定要求模式或資料而暴露出來。

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

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

注意：由於訊息處理器會在極早階段執行這項驗證，遠早於處理要求和在 API Proxy 中執行任何政策，因此 Trace 工具無法擷取因這個錯誤而失敗的要求。
  • HTTP 規格：
 RFC 第 3.3.2 節：Content-Length

修正

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

  1. 請確保用戶端應用程式一律將標頭 Content-Length 做為傳送至 Apigee 的 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
  • 原因：

TARGET_HEALTHCHECK_CONNECT_TIMEOUT

TARGET_HEALTHCHECK_CONNECTION_REFUSED

TARGET_HEALTHCHECK_HTTPS_REQUEST_OVER_HTTP

TARGET_HEALTHCHECK_UNEXPECTED_EOF
  • 可能原因：

如果您在 Apigee 中使用 TargetServer，則在下列情況下會發生這項錯誤：

  1. 自訂授權伺服器對後端伺服器主機的 DNS 解析錯誤，導致 IP 位址錯誤，進而發生連線錯誤。
  2. 連線逾時錯誤的原因：
    1. 後端伺服器的防火牆限制會導致 Apigee 無法連線至後端伺服器。
    2. Apigee 與後端伺服器之間的網路連線問題。
  3. TargetServer 中指定的主機不正確，或含有不必要的字元 (例如空格)。
如果設定用來監控目標伺服器健康狀態檢查的健康狀態檢查失敗，也可能發生這個錯誤。

messaging.adaptors.http.flow.RequestTimeOut
  • HTTP 狀態碼：
 408 Request Timeout
  • 錯誤訊息：
 Request timed out
  • 原因：
 CLIENT_READ_TIMEOUT
  • 可能原因：
 如果 Apigee Message Processor 在 Message Processor 元件上設定的 I/O 超時期間內，未收到來自用戶端應用程式的要求酬載，就會發生這個錯誤。

修正

確認用戶端應用程式在 Apigee 的 Message Processor 元件上設定的 I/O 超時期間內，傳送要求酬載。

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

TARGET_CONNECT_TIMEOUT

TARGET_WRITE_BROKEN_PIPE

TARGET_WRITE_CONNECTION_RESET_BY_PEER

TARGET_CONNECT_CONNECTION_REFUSED
  • 可能原因：

發生這個錯誤的原因如下：

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

修正

如要診斷及修正問題，請參閱 503 Service Unavailable error with TARGET_CONNECT_TIMEOUT playbook。
如果訊息處理器仍在將要求酬載傳送至後端伺服器，但後端伺服器卻過早關閉連線，也可能發生這個錯誤。

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

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

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

      • 或

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

      • 或

    • 含有不正確/不完整的憑證鏈結

  3. 後端伺服器拒絕 Apigee 使用的 TLS 版本。

    舉例來說，如果後端伺服器只接受 TLS 1.3 版，但 Apigee 端的目標伺服器在 TLS Protocol 欄位中設定了 TLS 1.2 版 (或完全未設定 TLS 版本，在這種情況下，Apigee 目前不會預設使用 TLS 1.3 版)，就會因通訊協定版本不符而導致連線失敗。

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

發生這個錯誤的原因如下：

  1. TargetServer 設定有誤，無法在 Apigee 中支援 TLS/SSL 連線。
  2. Apigee 等待後端伺服器回應時，後端伺服器可能會突然關閉連線。
  3. Apigee 和後端伺服器上設定的 Keep-Alive 超時時間有誤。

messaging.adaptors.http.flow.BadGateway
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Bad Gateway
  • 可能原因：

如果目標伺服器傳送格式錯誤的 HTTP 回應給 Apigee，就會發生這項錯誤。

messaging.runtime.*

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

如果 Apigee 無法將要求路由至任何 TargetEndpoint，就會發生這個錯誤，原因如下：

  • Proxy 中沒有符合要求的路徑規則 (<RouteRule>) 條件

    • 且

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

修正

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

  1. 檢查 ProxyEndpoint 中定義的路徑規則，並進行修改，確保至少有一項路徑規則條件符合您的要求。
  2. 如果有多個 RouteRule，建議您定義沒有條件的預設轉送規則。
  3. 請務必在條件式路徑清單中最後定義預設轉送規則，因為系統會在 ProxyEndpoint 中由上而下評估規則。

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

protocol.http.* - Caused due to bad request

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

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

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

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

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

修正

請確保用戶端應用程式傳送至 Apigee 的 HTTP 要求一律包含有效的標頭名稱，如 RFC 7230 第 3.2 節：標頭欄位所述。

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

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

修正

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

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

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

修正

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

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

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

修正

請確保用戶端應用程式傳送至 Apigee 的 HTTP 要求網址路徑，不含任何不允許的字元，如 RFC 3986 第 3.3 節：路徑所述。

protocol.http.MessageReadError
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 Unexpected I/O after message headers have been read.
  • 可能原因：
 MP 在非預期情況下收到管道上的 I/O 時，就會發生這種罕見錯誤。MP 正在讀取要求，已讀取所有標頭，並設定為讀取要求酬載。然後遇到似乎是相同標頭的 I/O 事件。

修正

找出記錄訊息，進一步瞭解發生了什麼事。 

logger.atSevere().log(
    "Unexpected I/O after message headers have been read. Channel diagnostics=%s."
        + " HeartBeat=%s",
    input.client().getDiagnostic(), message.getHeaders().isHeartBeat());

protocol.http.NoResolvedHost
  • HTTP 狀態碼：
 503 Service Unavailable
  • 錯誤訊息：

Unable to resolve host {hostname}

其中：{hostname} 是動態值，其值會根據提供的主機名稱而異。
  • 原因：
 TARGET_CONNECT_HOST_NOT_REACHABLE
  • 可能原因：
 如果指定的目標伺服器主機不正確或含有不必要的字元 (例如空格)，就會發生這個錯誤。

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

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

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

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果用戶端傳送的 Content-Encoding 標頭 (屬於 HTTP 回應的一部分) 包含 Apigee 不支援的編碼/酬載格式，就會發生這個錯誤。
  • 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 的 HTTP 回應中，出現 Apigee 不允許重複的特定 HTTP 標頭，且值相同或不同，就會發生這項錯誤。
  • HTTP 規格：
 RFC 7230 的 3.2.2 節：欄位順序

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

修正

請確保後端伺服器傳送至 Apigee 的 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 節：欄位值元件

修正

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

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 節：欄位值元件

修正

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

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

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

注意：錯誤訊息中的狀態碼 (faultstring) 會提供問題的高階原因。

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

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

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

修正

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

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 Method Not Allowed 和 RFC 7231 第 7.4.1 節：Allow

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

如果後端伺服器傳送給 Apigee 的 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 Reset Content

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

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

protocol.http.TooBigLine
  • HTTP 狀態碼：
 502 Bad Gateway
  • 錯誤訊息：
 response line size exceeding {limit}
  • 可能原因：
 如果後端伺服器傳送給 Apigee 的 HTTP 回應中，回應行的長度超過 Apigee Edge 允許的上限，就會發生這個錯誤。
  • 限制：
 Apigee 限制

protocol.http.UnsupportedEncoding
  • HTTP 狀態碼：
 415 Unsupported Media
  • 錯誤訊息：
 Unsupported Encoding "{encoding}"
  • 可能原因：
 如果後端伺服器在 HTTP 回應中傳送的 Content-Encoding 標頭包含 Apigee 不支援的編碼/酬載格式，就會發生這個錯誤。
  • 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 或 TargetServer 中參照的特定 KeyAlias 未在特定 Keystore 中找到，就會發生這個錯誤。

修正

確認 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 包含後端伺服器的有效憑證。