Katalog błędów środowiska wykonawczego

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Błędy w Apigee Edge

Gdy żądania do interfejsu API są wysyłane przez Apigee Edge, routery i procesory wiadomości Apigee Edge z komponentów Apigee Edge lub serwery backendu mogą zwracać błędy do aplikacji klienckich.

Błędy procesora wiadomości

Procesor wiadomości jest podstawowym komponentem Apigee Edge, który przetwarza zasady i komunikuje się z serwerami backendu. Funkcja zwraca błędy, jeśli wykryje jakiekolwiek problemy, na przykład:

  • Problemy z połączeniem sieciowym, błędy uzgadniania połączenia TLS, niedostępność serwera backendu, brak odpowiedzi podczas komunikacji z serwerem backendu
  • Błędy podczas wykonywania zasady
  • Nieprawidłowe nagłówki HTTP, kodowanie, ścieżka, niezgodność ze specyfikacją HTTP, przekroczenie limitów produktów itp.:
    • Za pomocą żądania HTTP wysłanego przez aplikacje klienckie

      • LUB

    • Z odpowiedzią HTTP przesłaną przez serwer backendu
  • I wiele więcej

Przykładowy błąd z procesora wiadomości

Procesor wiadomości zawsze zwraca kod stanu HTTP, a po nim komunikat o błędzie wraz z kodem błędu w formacie JSON, jak w tym przykładzie:

Aplikacja kliencka pobiera kod odpowiedzi podobny do tego: 

HTTP/1.1 414 Request-URI Too Long

Odpowiedź o błędzie z procesu przetwarzania wiadomości jest wyświetlana w takim formacie: 

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

Opis pól w odpowiedzi o błędzie:

Field Opis
faultstring Zawiera komunikat o błędzie z opisem jego możliwej przyczyny
errorcode Kod błędu (nazywany też kodem błędu) powiązany z błędem

Katalog błędów środowiska wykonawczego

Ten katalog błędów zawiera wszystkie potrzebne informacje o kodach błędów środowiska wykonawczego (w przypadku błędów niezwiązanych z zasadami) zwracanych przez komponent procesora wiadomości Apigee Edge. Zawiera on te informacje o każdym z kodów błędów:

  • Kod stanu HTTP
  • Komunikat o błędzie
  • Możliwe przyczyny błędu
  • Wszelkie powiązane specyfikacje HTTP lub limity usług
  • Poradniki i filmy zawierające instrukcje diagnozowania przyczyny błędu oraz skuteczne rozwiązania, które możesz zastosować, aby samodzielnie rozwiązać problem (jeśli są dostępne)
  • Rozwiązanie, które możesz zastosować, aby samodzielnie rozwiązać problem

Uwzględniamy te kategorie kodów błędów:

Użyj pola Szukaj poniżej, aby przefiltrować tabelę tak, aby wyświetlić powyższe informacje o konkretnym kodzie błędu. Możesz wyszukać kod stanu lub dowolną treść w dowolnym polu tabeli.

Kod błędu Opis Napraw

flow.*

flow.APITimedOut
  • Kod stanu HTTP:
 504 Gateway Timeout
  • Komunikat o błędzie:
 API timed out
  • Możliwa przyczyna:

Ten błąd występuje, jeśli:

  • Serwer backendu nie odpowiada w okresie oczekiwania skonfigurowanym przez właściwość api.timeout dla określonego serwera proxy interfejsu API.
  • Zasada zajmuje dużo czasu z powodu intensywnych operacji obliczeniowych, dużego obciążenia lub niskiej wydajności.

Uwaga: ten scenariusz zawiera instrukcje dotyczące rozwiązywania problemów z kodem błędu messaging.adaptors.http.flow.GatewayTimeout. Możesz jednak użyć tego samego scenariusza do rozwiązywania problemów z kodem błędu flow.APITimedOut.

PORADNIK

flow.SharedFlowNotFound
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 Shared Flow {shared_flow_name} Not Found
  • Możliwa przyczyna:

Ten błąd występuje, jeśli konkretny udostępniony przepływ:

  • Nie istnieje

    • LUB

  • Istnieje, ale nie jest wdrożona
PORADNIK

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • Kod stanu HTTP:
 404 Not Found
  • Komunikat o błędzie:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Możliwa przyczyna:

Ten błąd występuje w jednym z tych scenariuszy:

  1. Konkretny serwer proxy API to:
    1. NIE skonfigurowano do akceptowania żądań dotyczących konkretnego hosta wirtualnego
    2. NIE skonfigurowano do akceptowania żądań na określonej ścieżce używanej w żądaniu
    3. NIE wdrożone w konkretnym środowisku, w którym próbujesz wysyłać żądania do interfejsu API
    4. NIE wdrożono w co najmniej jednym procesorze wiadomości
  2. Konkretne środowisko, w którym próbujesz wysyłać żądania do interfejsu API, nie jest wczytywane przez co najmniej jeden procesor wiadomości
 PORADNIK
Ten błąd może też wystąpić, jeśli wiele hostów wirtualnych ma ten sam alias hosta i ten sam numer portu. PORADNIK

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • Kod stanu HTTP:
 400 Bad Request
  • Komunikat o błędzie:
 Decompression failure at request
  • Możliwa przyczyna:

Ten błąd występuje tylko wtedy, gdy:

  • Kodowanie określone w nagłówku żądania HTTP Content-Encoding jest prawidłowe i obsługiwane przez Apigee Edge,

    • ALE

  • Format ładunku wysłany przez klienta w ramach żądania HTTP nie pasuje do formatu kodowania określonego w nagłówku Content-Encoding
PORADNIK

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Decompression failure at response
  • Możliwa przyczyna:

Ten błąd występuje tylko wtedy, gdy:

  • Kodowanie określone w nagłówku odpowiedzi HTTP Content-Encoding backendu/serwera docelowego jest prawidłowe i obsługiwane przez Apigee Edge,

    • ALE

  • Format ładunku wysyłany przez backend/serwer docelowy w ramach odpowiedzi HTTP nie pasuje do formatu kodowania określonego w nagłówku Content-Encoding
PORADNIK

messaging.adaptors.http.flow.ErrorResponseCode
  • Kod stanu HTTP:
 500

PORADNIK

FILM

  • Komunikat o błędzie:
 Komunikat o błędzie i format mogą się różnić w zależności od implementacji serwera backendu.
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli serwer backendu wysyła kod stanu 500 do Apigee Edge.
  • Kod stanu HTTP:
 503

PORADNIK

FILM

  • Komunikat o błędzie:
 Komunikat o błędzie i format mogą się różnić w zależności od implementacji serwera backendu.
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli serwer backendu wysyła kod stanu 503 do Apigee Edge.
  • Kod stanu HTTP:
 504 PORADNIK
  • Komunikat o błędzie:
 Komunikat o błędzie i format mogą się różnić w zależności od implementacji serwera backendu.
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli serwer backendu wysyła kod stanu 504 do Apigee Edge.

Uwaga: w komunikacie o błędzie wysłanym do aplikacji klienckich nie zwracamy kodu błędu messaging.adaptors.http.flow.ErrorResponseCode. Wynika to z tego, że ten kod błędu jest ustawiany przez Apigee Edge za każdym razem, gdy serwer backendu zwróci błąd i dowolny z kodów stanu 4XX lub 5XX. Możesz wyświetlić ten kod błędu w monitorowaniu interfejsów API, logach dostępu NGINX lub analitycznej bazie danych.

messaging.adaptors.http.flow.GatewayTimeout
  • Kod stanu HTTP:
 504 Gateway Timeout
  • Komunikat o błędzie:
 Gateway Timeout
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli serwer backendu nie odpowiada na procesor komunikatów Apigee Edge w ciągu limitu czasu oczekiwania wejścia/wyjścia skonfigurowanego w tym procesorze wiadomości.
PORADNIK

messaging.adaptors.http.flow.LengthRequired
  • Kod stanu HTTP:
 411 Length Required
  • Komunikat o błędzie:
 'Content-Length' is missing
  • Możliwa przyczyna:

Ten błąd występuje, jeśli nagłówek Content-Length nie jest przekazywany przez aplikację kliencką w ramach żądań HTTP POST i PUT wysyłanych do Apigee Edge.

Uwaga: żądań, w przypadku których wystąpił ten błąd, nie można przechwytywać w narzędziu do śledzenia, ponieważ podmiot przetwarzający wiadomości przeprowadza weryfikację na bardzo wczesnej fazie, na długo przed przetworzeniem żądania i wykonaniem jakiejkolwiek zasady w serwerze proxy interfejsu API.
  • Specyfikacja HTTP:
 Sekcja 3.3.2 RFC: Długość treści

Napraw

Aby naprawić ten błąd, wykonaj te czynności:

  1. Upewnij się, że aplikacja kliencka zawsze przekazuje nagłówek Content-Length jako część żądań HTTP POST i PUT wysyłanych do Apigee Edge. Na przykład:

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

  2. Nawet jeśli przekazujesz pusty ładunek z żądaniami POST i PUT, zadbaj o to, by nagłówek Content-Length: 0 został przekazany. Na przykład:

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

messaging.adaptors.http.flow.NoActiveTargets
  • Kod stanu HTTP:
 503 Service Unavailable
  • Komunikat o błędzie:
 The Service is temporarily unavailable
  • Możliwa przyczyna:

Ten błąd występuje w jednym z tych scenariuszy, jeśli używasz serwera docelowego w Apigee Edge:

  1. Niepoprawne rozpoznawanie nazw DNS hosta serwera backendu przez niestandardowy serwer autoryzacji spowodowało nieprawidłowe adresy IP i błędy połączenia.
  2. Błędy przekroczenia limitu czasu połączenia z następujących powodów:
    1. Ograniczenie zapory sieciowej na serwerze backendu uniemożliwia Apigee Edge nawiązanie połączenia z serwerem backendu.
    2. Problemy z połączeniem sieciowym między Apigee Edge a serwerem backendu.
  3. Host określony w serwerze docelowym jest nieprawidłowy lub zawiera niechciane znaki (takie jak spacja).

PORADNIK

FILM
Ten błąd może też wystąpić, jeśli nie powiodą się kontrole stanu skonfigurowane pod kątem monitorowania stanu serwerów docelowych.

PORADNIK

FILM

messaging.adaptors.http.flow.RequestTimeOut
  • Kod stanu HTTP:
 408 Request Timeout
  • Komunikat o błędzie:
 Request timed out
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli procesor wiadomości Apigee Edge nie otrzyma ładunku żądania z aplikacji klienckiej przez okres oczekiwania wejścia-wyjścia skonfigurowany w komponencie Message Processor.

Napraw

Upewnij się, że aplikacja kliencka wysyła ładunek żądania w ramach limitu czasu wejścia-wyjścia skonfigurowanego w komponencie Message Processor w Apigee Edge.

messaging.adaptors.http.flow.ServiceUnavailable
  • Kod stanu HTTP:
 503 Service Unavailable
  • Komunikat o błędzie:
 The Service is temporarily unavailable
  • Możliwa przyczyna:

Ten błąd występuje w jednym z tych scenariuszy:

  1. Niepoprawne rozpoznawanie nazw DNS hosta serwera backendu przez niestandardowy serwer autoryzacji spowodowało nieprawidłowe adresy IP i błędy połączenia.
  2. Błędy związane z przekroczeniem limitu czasu połączenia z tych powodów:
    1. Ograniczenie zapory sieciowej na serwerze backendu uniemożliwia Apigee Edge nawiązanie połączenia z serwerem backendu.
    2. Problemy z połączeniem sieciowym między Apigee Edge a serwerem backendu.
  3. Host serwera docelowego określony w docelowym punkcie końcowym jest nieprawidłowy lub zawiera niechciane znaki (takie jak spacja).

PORADNIK

Błąd DNS:

FILM

Połączenia sieciowe:

FILM
Ten błąd może również wystąpić, jeśli serwer backendu przedwcześnie zamknie połączenie, gdy procesor wiadomości nadal wysyła ładunek żądania do serwera backendu. PORADNIK

messaging.adaptors.http.flow.SslHandshakeFailed
  • Kod stanu HTTP:
 503 Service Unavailable
  • Komunikat o błędzie:
 SSL Handshake failed {error_message}
  • Możliwa przyczyna:

Ten błąd występuje podczas uzgadniania połączenia SSL między procesorem wiadomości Apigee Edge a serwerem backendu, jeśli:

  1. Magazyn zaufania procesora wiadomości Apigee Edge:
    • Zawiera łańcuch certyfikatów, który nie pasuje do pełnego łańcucha certyfikatów serwera backendu

      • LUB

    • Nie zawiera pełnego łańcucha certyfikatów serwera backendu
  2. Łańcuch certyfikatów przedstawiany przez serwer backendu:
    • Zawiera pełną i jednoznaczną nazwę domeny (FQDN), która nie pasuje do nazwy hosta podanej w docelowym punkcie końcowym

      • LUB

    • Zawiera nieprawidłowy lub niekompletny łańcuch certyfikatów

PORADNIK

FILM

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Unexpected EOF at target
  • Możliwa przyczyna:

Ten błąd występuje w jednym z tych scenariuszy:

  1. Serwer docelowy nie jest prawidłowo skonfigurowany do obsługi połączeń TLS/SSL w Apigee Edge.
  2. Serwer backendu może nagle zakończyć połączenie, gdy Apigee Edge czeka na odpowiedź serwera backendu.
  3. Utrzymywanie czasu aktywności jest nieprawidłowo skonfigurowane na Apigee i serwerze backendu.
PORADNIK

messaging.runtime.*

messaging.runtime.RouteFailed
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 Unable to route the message to a TargetEndpoint
  • Możliwa przyczyna:

Ten błąd występuje, jeśli Apigee Edge nie może przekierować żądania do żadnego z docelowych punktów końcowych, ponieważ:

  • Nie ma warunku reguły trasy (<RouteRule>), który pasuje do żądania na serwerze proxy

    • ORAZ

  • W punkcie końcowym ProxyEndpoint nie ma zdefiniowanej domyślnej reguły trasy (np. <RouteRule> bez warunku)

Napraw

Aby naprawić ten błąd, wykonaj następujące czynności:

  1. Sprawdź reguły trasy zdefiniowane w punkcie ProxyEndpoint i zmodyfikuj te reguły, aby mieć pewność, że istnieje co najmniej 1 warunek reguły trasy zgodny z Twoim żądaniem.
  2. Jeśli masz wiele reguł trasy, warto zdefiniować domyślną regułę trasy bez warunku.
  3. Sprawdź, czy domyślna reguła trasy jest zawsze definiowana na końcu na liście tras warunkowych, ponieważ reguły są oceniane z góry w punkcie końcowym ProxyEndpoint.

Więcej informacji o definiowaniu warunków <RouteRule> w punkcie końcowym ProxyEndpoint znajdziesz w sekcji dotyczącej celów warunkowych.

messaging.runtime.SenseRaiseFault
  • Kod stanu HTTP:
 403 Forbidden
  • Komunikat o błędzie:
 Sense Fault
  • Możliwa przyczyna:
 Ten błąd występuje, gdy żądanie do interfejsu API jest wysyłane z określonego adresu IP klienta, który jest zablokowany przez reguły Apigee Sense.

Napraw

Aby naprawić ten błąd, wykonaj następujące czynności:

  1. Sprawdź, czy dany adres IP klienta został zablokowany, sprawdzając reguły skonfigurowane w Apigee Sense. Jeśli jest zablokowany, oznacza to, że działa zgodnie z założeniami.
  2. Jeśli konkretny adres IP klienta nie jest zablokowany, ale nadal występuje ten błąd, skontaktuj się z zespołem pomocy Apigee Edge.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 Bad Form Data
  • Możliwa przyczyna:

Ten błąd występuje tylko wtedy, gdy są spełnione wszystkie te warunki:

  1. Żądanie HTTP wysłane przez klienta do Apigee Edge zawiera:
    • Content-Type: application/x-www-form-urlencoded i
    • Dane formularzy ze znakiem procentu (%) lub znakiem procentu (%), po którym następują nieprawidłowe znaki szesnastkowe, które są niedozwolone zgodnie z Formularzami – sekcja 17.13.4.1.
  2. Serwer proxy interfejsu API w Apigee Edge odczytuje określone parametry formularza zawierające wszelkie znaki niedozwolone za pomocą zasady ExtractVariables lub zasady AssignMessage w przepływie żądania.
PORADNIK

protocol.http.DuplicateHeader
  • Kod stanu HTTP:
 400 Bad Request
  • Komunikat o błędzie:
 Duplicate Header "{header_name}"
  • Możliwa przyczyna:
 Ten błąd występuje, gdy konkretny nagłówek HTTP, który nie może mieć duplikatów w Apigee Edge, pojawia się więcej niż raz z takimi samymi lub różnymi wartościami w żądaniu HTTP wysłanym przez aplikację kliencką do Apigee Edge.
  • Specyfikacja HTTP:
 RFC 7230, sekcja 3.2.2: Field Order
PORADNIK

protocol.http.EmptyHeaderName
  • Kod stanu HTTP:
 400 Bad Request
  • Komunikat o błędzie:
 Header name cannot be empty
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nazwa nagłówka wysłana w ramach żądania HTTP przez aplikację kliencką do Apigee Edge jest pusta.
  • Specyfikacja HTTP:
 RFC 7230, sekcja 3.2: Pola nagłówka

Napraw

Sprawdź, czy żądanie HTTP wysyłane przez aplikację kliencką do Apigee Edge zawsze zawiera prawidłową nazwę nagłówka zgodnie ze standardem RFC 7230, sekcja 3.2: pola nagłówka.

protocol.http.HeaderNameWithNonAsciiChar
  • Kod stanu HTTP:
 400 Bad Request
  • Komunikat o błędzie:
 Header {header_name} contains non ascii character {character}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nazwa nagłówka wysłana w ramach żądania HTTP przez aplikację kliencką do Apigee Edge zawiera znaki spoza zestawu ASCII.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: Pola nagłówka i RFC 7230, sekcja 3.2.6: Komponenty wartości pól

Napraw

Upewnij się, że żądanie HTTP klienta wysłane do Apigee Edge nie zawiera w nazwach nagłówków znaków spoza zestawu ASCII zgodnie z RFC 7230, sekcja 3.2.6: komponenty wartości pól.

protocol.http.HeaderWithInvalidChar
  • Kod stanu HTTP:
 400 Bad Request
  • Komunikat o błędzie:
 Header {header_name} contains invalid character {character}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nazwa nagłówka wysłana w ramach żądania HTTP przez aplikację kliencką do Apigee Edge zawiera nieprawidłowe znaki, takie jak równość (=), przecinek (,), średnik (;), tabulator, CRLF i znak nowego wiersza.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: Pola nagłówka i RFC 7230, sekcja 3.2.6: Komponenty wartości pól

Napraw

Sprawdź, czy żądanie HTTP wysłane przez aplikację kliencką do Apigee Edge nie zawiera żadnych nieprawidłowych znaków w nazwach nagłówków zgodnie z RFC 7230, sekcja 3.2.6: komponenty wartości pola.

protocol.http.InvalidPath
  • Kod stanu HTTP:
 400 Bad Request
  • Komunikat o błędzie:
 Invalid path {path}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli ścieżka w adresie URL żądania HTTP wysłana przez aplikację kliencką do Apigee Edge zawiera znaki niedozwolone zgodnie ze specyfikacją RFC 3986, sekcja 3.3: Ścieżka.
  • Specyfikacja HTTP:

RFC 3986, sekcja 3. Komponenty składni i RFC 3986, sekcja 3.3: Ścieżka

Napraw

Upewnij się, że ścieżka w adresie URL żądania HTTP wysłana przez aplikację kliencką do Apigee Edge nie zawiera żadnych znaków niedozwolonych jako zgodnie z sekcją 3.3: Ścieżka w dokumencie RFC 3986.

protocol.http.TooBigBody
  • Kod stanu HTTP:
 413 Request Entity Too Large
  • Komunikat o błędzie:
 Body buffer overflow
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli rozmiar ładunku wysyłany przez aplikację kliencką w ramach żądania HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee Edge
PORADNIK

protocol.http.TooBigHeaders
  • Kod stanu HTTP:
 431 Request Header Fields Too Large
  • Komunikat o błędzie:
 request headers size exceeding {limit}
  • Możliwa przyczyna:
 Łączny rozmiar wszystkich nagłówków żądań wysyłanych przez aplikację kliencką w ramach żądania HTTP do Apigee Edge jest większy niż dozwolony limit w Apigee Edge.
  • Specyfikacja HTTP:
 RFC 6585, sekcja 5: 431 Pola nagłówka żądania są za duże
  • Limity:
 Limity Edge Apigee
PORADNIK

protocol.http.TooBigLine
  • Kod stanu HTTP:
 414 Request-URI Too Long
  • Komunikat o błędzie:
 request line size exceeding {limit}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli rozmiar wiersza żądania wysyłanego przez aplikację kliencką w ramach żądania HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee Edge
PORADNIK

protocol.http.UnsupportedEncoding
  • Kod stanu HTTP:
 415 Unsupported Media
  • Komunikat o błędzie:
 Unsupported Encoding "{encoding}"
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nagłówek Content-Encoding wysłany przez klienta w ramach odpowiedzi HTTP zawiera format kodowania/ładunku, który nie jest obsługiwany przez Apigee Edge.
  • Specyfikacja HTTP:
 RFC 7231, sekcja 6.5.13: 415 Nieobsługiwany typ nośnika
PORADNIK

protocol.http.* - Caused by target

protocol.http.BadPath
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 Invalid request path
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli URL żądania serwera backendu, reprezentowany przez zmienną przepływu target.url, zawiera ścieżkę rozpoczynającą się znakiem zapytania (?) zamiast ukośnikiem (/), co jest nieprawidłowe.
  • Specyfikacja HTTP:

RFC 3986, sekcja 3. Komponenty składni i RFC 3986, sekcja 3.3: Ścieżka
PORADNIK

protocol.http.DuplicateHeader
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Duplicate Header "{header_name}"
  • Możliwa przyczyna:
 Ten błąd występuje, gdy konkretny nagłówek HTTP, który nie może mieć duplikatów w Apigee Edge, pojawia się więcej niż raz z takimi samymi lub różnymi wartościami w odpowiedzi HTTP wysłanej przez serwer backendu do Apigee Edge.
  • Specyfikacja HTTP:
 RFC 7230, sekcja 3.2.2: Field Order
PORADNIK

protocol.http.EmptyHeaderName
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Header name cannot be empty
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nazwa nagłówka wysyłana przez serwer backendu w ramach odpowiedzi HTTP do Apigee Edge jest pusta.
  • Specyfikacja HTTP:
 RFC 7230, sekcja 3.2: Pola nagłówka

Napraw

Sprawdź, czy odpowiedź HTTP wysyłana przez serwer backendu do Apigee Edge zawsze zawiera prawidłową nazwę nagłówka zgodnie ze standardem RFC 7230, sekcja 3.2: pola nagłówka.

protocol.http.EmptyPath
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 Request path cannot be empty
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli URL żądania HTTP serwera backendu reprezentowany przez zmienną przepływu target.url zawiera pustą ścieżkę.
  • Specyfikacja HTTP:

RFC 3986, sekcja 3. Komponenty składni i RFC 3986, sekcja 3.3: Ścieżka
PORADNIK

protocol.http.HeaderNameWithNonAsciiChar
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Header {header_name} contains non ascii character {character}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nazwa nagłówka wysłana przez serwer backendu w ramach odpowiedzi HTTP do Apigee Edge zawiera znaki spoza zestawu ASCII.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: Pola nagłówka i RFC 7230, sekcja 3.2.6: Komponenty wartości pól

Napraw

Sprawdź, czy odpowiedź HTTP serwera backendu wysłana do Apigee Edge nie zawiera w nazwach nagłówków znaków spoza zestawu ASCII zgodnie z RFC 7230, sekcja 3.2.6: komponenty wartości pola.

protocol.http.HeaderWithInvalidChar
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Header {header_name} contains invalid character {character}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nazwa nagłówka wysłana przez serwer backendu w odpowiedzi HTTP zawiera nieprawidłowe znaki, takie jak równość (=), przecinek (,), średnik (;), tabulator, CRLF i znak nowego wiersza.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: Pola nagłówka i RFC 7230, sekcja 3.2.6: Komponenty wartości pól

Napraw

Sprawdź, czy odpowiedź HTTP serwera backendu wysłana do Apigee Edge nie zawiera żadnych nieprawidłowych znaków w nazwach nagłówków zgodnie z RFC 7230, sekcja 3.2.6: komponenty wartości pola

protocol.http.ProxyTunnelCreationFailed
  • Kod stanu HTTP:
 503 Service Unavailable
  • Komunikat o błędzie:
 Proxy refused to create tunnel with response status {status code}
  • Możliwa przyczyna:

Ten błąd występuje podczas tworzenia tunelu między Apigee Edge a serwerem backendu przez serwer proxy z powodu zapory sieciowej, listy kontroli dostępu (listy kontroli dostępu), problemów z DNS, dostępności dostępności serwera backendu itp.

Uwaga: kod stanu w komunikacie o błędzie (faultstring) zawiera ogólną przyczynę problemu.
PORADNIK

protocol.http.Response306Reserved
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Response Status code 306 is reserved, so can't be used.
  • Możliwa przyczyna:

Ten błąd występuje, jeśli serwer backendu odpowiedział z kodem stanu 306 do Apigee Edge.

Kod stanu 306 był zdefiniowany w poprzedniej wersji specyfikacji HTTP. Zgodnie z bieżącą specyfikacją HTTP ten kod jest zarezerwowany i nie należy go używać.
  • Specyfikacja HTTP:
 RFC 7231, sekcja 6.3.5: 306 Zarezerwowany

Napraw

Kod stanu 306 jest zarezerwowany, dlatego serwer backendu nie może używać tego kodu stanu podczas wysyłania odpowiedzi do Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Received 405 Response without Allow Header
  • Możliwa przyczyna:
 Serwer backendu odpowiada kodem stanu 405 Method Not Allowed bez nagłówka „Allow”.
  • Specyfikacja HTTP:

RFC 7231, sekcja 6.5.5: Niedozwolona metoda 405 i RFC 7231, sekcja 7.4.1: Zezwalaj
PORADNIK

protocol.http.ResponseWithBody
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Received {status_code} Response with message body
  • Możliwa przyczyna:

Ten błąd występuje, jeśli odpowiedź HTTP z serwera backendu do Apigee Edge ma postać 204 No Content lub 205 Reset Content, ale zawiera treść odpowiedzi lub co najmniej jeden z tych nagłówków:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • Specyfikacja HTTP:

RFC 7231, sekcja 6.3.5: 204 Brak zawartości i RFC 7231, sekcja 6.3.6: 205 Resetuj zawartość
PORADNIK

protocol.http.TooBigBody
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 Body buffer overflow
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli rozmiar ładunku wysyłany przez aplikację kliencką w ramach żądania HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee Edge
PORADNIK

protocol.http.TooBigHeaders
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 response headers size exceeding {limit}
  • Możliwa przyczyna:
 Ten błąd występuje, gdy łączny rozmiar wszystkich nagłówków odpowiedzi wysyłanych przez serwer backendu w ramach odpowiedzi HTTP do Apigee Edge jest większy niż dozwolony limit w Apigee Edge.
  • Limity:
 Limity Edge Apigee
PORADNIK

protocol.http.TooBigLine
  • Kod stanu HTTP:
 502 Bad Gateway
  • Komunikat o błędzie:
 response line size exceeding {limit}
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli rozmiar wiersza odpowiedzi wysyłanego przez serwer backendu w ramach odpowiedzi HTTP do Apigee Edge jest większy niż dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee Edge
PORADNIK

protocol.http.UnsupportedEncoding
  • Kod stanu HTTP:
 415 Unsupported Media
  • Komunikat o błędzie:
 Unsupported Encoding "{encoding}"
  • Możliwa przyczyna:
 Ten błąd występuje, jeśli nagłówek Content-Encoding wysyłany przez serwer backendu w ramach odpowiedzi HTTP zawiera format kodowania/ładunku, który nie jest obsługiwany przez Apigee Edge.
  • Specyfikacja HTTP:
 RFC 7231, sekcja 6.5.13: 415 Nieobsługiwany typ nośnika
PORADNIK

security.util.*

security.util.KeyAliasNotFound
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Możliwa przyczyna:

Ten błąd występuje, jeśli w określonym magazynie kluczy nie znaleziono określonego aliasu klucza, do którego odwołuje się docelowy punkt końcowy lub serwer docelowy.

Napraw

Sprawdź, czy alias klucza określony w punkcie docelowym lub serwerze docelowym istnieje i jest częścią konkretnego magazynu kluczy.

security.util.TrustStoreWithNoCertificates
  • Kod stanu HTTP:
 500 Internal Server Error
  • Komunikat o błędzie:
 TrustStore {truststore_name} has no certificates
  • Możliwa przyczyna:

Ten błąd występuje, jeśli określony magazyn zaufania, do którego odwołuje się docelowy punkt końcowy lub serwer docelowy, nie zawiera żadnych certyfikatów.

Napraw

Jeśli chcesz zweryfikować certyfikat serwera backendu i chcesz używać magazynu Trust Store w punkcie docelowym lub serwerze docelowym, sprawdź, czy magazyn zaufania zawiera prawidłowe certyfikaty serwera backendu.