Katalog błędów środowiska wykonawczego

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Błędy w Apigee Edge

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

Błędy procesora wiadomości

Procesor wiadomości to podstawowy komponent Apigee Edge, który przetwarza zasady i współdziała z serwerami backendu. Może zwrócić błędy, jeśli wykryje problemy takie jak:

  • Problemy z połączeniem sieciowym, błędy uzgadniania połączenia TLS, niedostępność serwera backendu brak odpowiedzi w trakcie komunikacji z serwerem backendu
  • Błędy podczas wykonywania zasady
  • Nieprawidłowe nagłówki HTTP, kodowanie, ścieżka, brak zgodności ze specyfikacją HTTP, przekroczenie limity produktów itp.:
    • Żądanie HTTP wysyłane przez aplikacje klienckie

      • LUB

    • Odpowiedź HTTP wysyłana przez serwer backendu
  • I wiele więcej

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

Procesor wiadomości zawsze zwraca kod stanu HTTP, po którym następuje komunikat o błędzie wraz z z kodem błędu w formacie JSON, jak poniżej:

Aplikacja kliencka otrzymuje kod odpowiedzi podobny do tego: 

HTTP/1.1 414 Request-URI Too Long

Odpowiedź o błędzie z procesora wiadomości ma następujący format: 

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

Opis pól w odpowiedzi na błąd:

Pole Opis
faultstring Zawiera komunikat o błędzie opisujący możliwą przyczynę błędu
errorcode Kod błędu (nazywany też kodem błędu) powiązany z parametrem błąd

Katalog błędów środowiska wykonawczego

Ten katalog błędów zawiera wszystkie informacje o środowisku wykonawczym kody błędów (w przypadku błędów niezwiązanych z zasadami) zwracane przez Apigee Edge Message Komponent procesora. Zawiera on następujące informacje dla każdego kodu błędu:

  • Kod stanu HTTP
  • Komunikat o błędzie
  • Możliwe przyczyny błędu
  • wszelkie powiązane specyfikacje HTTP lub limity produktów.
  • Poradniki i filmy zawierające instrukcje diagnozowania przyczyny błędu oraz skutecznych rozwiązań, które można zastosować w celu samodzielnego usunięcia błędu (jeśli są dostępne).
  • Popraw, który możesz zastosować, aby samodzielnie naprawić błąd

Obejmuje to te kategorie kodów błędów:

Użyj pola Szukaj poniżej, aby przefiltrować tabelę i wyświetlić powyższe informacje dla konkretnego kodu błędu. Możesz wyszukać kod stanu lub dowolną treść w dowolnym polu w 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 skonfigurowanym okresie oczekiwania przez obiekt api.timeout dla określonego serwera proxy interfejsu API.
  • Działanie zasady trwa bardzo długo z powodu operacji intensywnie obliczeniowych, wysokie lub niskiej wydajności.

Uwaga: ten poradnik zawiera instrukcje rozwiązywania problemów z kodem błędu. messaging.adaptors.http.flow.GatewayTimeout; jednak możesz użyć za pomocą tego samego poradnika 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 została 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. Odpowiedni serwer proxy interfejsu API to:
    1. NIE skonfigurowano do akceptowania żądań dotyczących określonego Host wirtualny
    2. NIE skonfigurowano do akceptowania żądań na określonej ścieżce użyte w żądaniu
    3. NIE jest wdrażany w konkretnym środowisku, w którym próbują wysyłać żądania do interfejsu API
    4. NIE wdrożono w co najmniej jednym procesorze wiadomości
  2. W konkretnym środowisku żądania do interfejsu API nie są wczytywane w co najmniej jednym procesorze wiadomości.
 PORADNIK
Ten błąd może też występować, jeśli wiele hostów wirtualnych ma tego samego hosta alias i 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 Parametr Content-Encoding jest prawidłowy i obsługiwane przez Apigee Edge,

    • ALE

  • Format ładunku wysyłany przez klienta w ramach żądania HTTP żądanie nie pasuje do formatu kodowania określonego w Content-Encoding nagłówek
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 parametrze Nagłówek odpowiedzi HTTP Content-Encoding jest prawidłowy i obsługiwane przez Apigee Edge,

    • ALE

  • Format ładunku wysyłany przez serwer backendu/serwer docelowy jako nie pasuje do formatu kodowania określonego w parametrze Content-Encoding nagłówek
PORADNIK

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

PORADNIK

FILM

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

PORADNIK

FILM

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

Uwaga: kod błędu Nie zwrócono: messaging.adaptors.http.flow.ErrorResponseCode jako część komunikatu o błędzie wysyłanego do aplikacji klienckich. To jest ponieważ ten kod błędu jest ustawiany przez Apigee Edge za każdym razem, gdy serwer backendu odpowiada z błędem i dowolnym z 4XX lub 5XX kodów stanu. Ten kod błędu możesz wyświetlić w usłudze API Monitoring, logach dostępu NGINX czy bazy danych analitycznych.

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, gdy serwer backendu nie odpowiada do procesora wiadomości brzegowych Apigee w Limit czasu wejścia-wyjścia skonfigurowany w 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 HTTP POST i PUT Żądania wysłane do Apigee Edge

Uwaga: żądania z tym błędem. nie może zostać przechwycona w narzędziu Trace, ponieważ tę weryfikację jest bardzo wczesna, na długo przed rozpatrywaniem prośby i wykonywania dowolnej zasady na serwerze proxy API.
  • Specyfikacja HTTP:
 RFC 3.3.2: długość treści

Napraw

Aby rozwiązać ten problem, wykonaj te czynności:

  1. Sprawdź, czy aplikacja kliencka zawsze przekazuje nagłówek Content-Length w ramach protokołu HTTP POST oraz Wysłano żądania (PUT) 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 za pomocą funkcji POST i PUT żądań, upewnij się, że nagłówek Content-Length: 0 zaliczono. 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 Serwer docelowy w Apigee Edge:

  1. Nieprawidłowa rozpoznawanie nazw DNS hosta serwera backendu przez niestandardowy serwer autoryzacji spowodowały wystąpienie nieprawidłowych adresów IP, prowadzące do błędów połączenia.
  2. Błędy przekroczenia limitu czasu połączenia z powodu:
    1. Ograniczenie zapory sieciowej na serwerze backendu uniemożliwia Połączenie Apigee Edge z serwerem backendu.
    2. Problemy z połączeniem sieciowym między Apigee Edge i serwera backendu.
  3. Host określony na serwerze docelowym jest nieprawidłowy lub zawiera niechciane znaki (np. spację).

PORADNIK

FILM
Ten błąd może też wystąpić, jeśli kontrole stanu skonfigurowane pod kątem monitorowania stanu nie uda się sprawdzić 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 komunikatów brzegowych Apigee nie otrzyma żądania z aplikacji klienckiej dla Limit czasu wejścia-wyjścia skonfigurowany w komponencie procesora wiadomości.

Napraw

Upewnij się, że aplikacja kliencka wysyła ładunek żądania w tagu Limit czasu wejścia-wyjścia skonfigurowany w komponencie przetwarzania wiadomości 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. Nieprawidłowa rozpoznawanie nazw DNS serwera backendu Niestandardowy serwer autoryzacji spowodował wystąpienie nieprawidłowych adresów IP prowadzących do na błędy połączenia.
  2. Błędy przekroczenia limitu czasu połączenia z powodu:
    1. Ograniczenie zapory sieciowej na serwerze backendu uniemożliwia Połączenie Apigee Edge z serwerem backendu.
    2. Problemy z połączeniem sieciowym między Apigee Edge a z serwera backendu.
  3. Host serwera docelowego określony w docelowym punkcie końcowym to nieprawidłowe lub zawierają niechciane znaki (np. spacja).

PORADNIK

Błąd DNS:

FILM

Łączność sieciowa:

FILM
Ten błąd może również wystąpić, jeśli serwer backendu przedwcześnie zamknie gdy procesor wiadomości nadal wysyła ładunek żądania do z 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 Apigee Edge Procesor komunikatów i serwer backendu, jeśli:

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

      • LUB

    • Nie zawiera pełnego łańcucha certyfikatów serwera backendu
  2. Łańcuch certyfikatów przedstawiany przez serwer backendu:
    • Zawiera w pełni kwalifikowaną nazwę domeny (FQDN), która nie jest zgodna z nazwa hosta określona 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 zamknąć połączenie, gdy Apigee Edge czeka na odpowiedź z serwera backendu.
  3. Utrzymuj nieprawidłowo skonfigurowane limity czasu aktywności w Apigee i z serwera 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 skierować żądania do żadnej TargetEndpoints, ponieważ:

  • Nie ma warunku trasy (<RouteRule>), pasuje do żądania w serwerze proxy

    • ORAZ

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

Napraw

Aby rozwiązać ten problem, wykonaj te czynności:

  1. Sprawdź reguły trasy zdefiniowane w punkcie końcowym proxy i zmodyfikuj je, by mieć pewność, że istnieje co najmniej jeden warunek reguły trasy pasujący do Twojego żądania.
  2. Warto zdefiniować domyślną regułę trasy bez warunku. jeśli masz wiele reguł trasy.
  3. Upewnij się, że domyślna reguła trasy jest zawsze zdefiniowana jako ostatnia na liście Trasy warunkowe, ponieważ reguły są oceniane od góry w punkcie końcowym serwera proxy.

Więcej informacji o definiowaniu warunków <RouteRule> w ProxyEndpoint, patrz Cele warunkowe.

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

Napraw

Aby rozwiązać ten problem, wykonaj te czynności:

  1. Sprawdź, czy konkretny adres IP klienta został zablokowany przez sprawdzając reguły skonfigurowane w Apigee Sense. Jeśli jest zablokowany, co będzie oznaczało, że działa on zgodnie z założeniami.
  2. Jeśli konkretny adres IP klienta nie jest blokowany, ale wciąż jesteś zobaczysz 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 poniższe warunki:

  1. Żądanie HTTP wysłane przez klienta do Apigee Edge zawiera:
    • Content-Type: application/x-www-form-urlencoded, oraz
    • Dane formularza ze znakiem procentu (%) lub wartością procentową znak (%), po którym występują nieprawidłowe, niedozwolone znaki szesnastkowe zgodnie z Formularze – artykuł 17.13.4.1.
  2. Serwer proxy interfejsu API w Apigee Edge odczytuje określony formularz parametrów zawierających wszelkie znaki, które nie są dozwolone przy użyciu parametru Wyodrębnij z nich zmienne lub zasadę AssignMessage w przepływie żądań.
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, jeśli konkretny nagłówek HTTP nie może mieć duplikatów w Apigee Edge występuje więcej niż raz z tymi samymi lub różnymi wartościami w ramach parametru Żądanie HTTP wysłane 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 wysyłana jako część żądanie aplikacji klienckiej do Apigee Edge jest puste.
  • Specyfikacja HTTP:
 RFC 7230, sekcja 3.2: pola nagłówka

Napraw

Sprawdź, czy żądanie HTTP wysłane przez aplikację kliencką do Apigee Edge zawsze zawiera prawidłową nazwę nagłówka, taką jak RFC 7230, sekcja 3.2: Header Fields (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 ze znaków innych niż ASCII.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: Header Fields oraz RFC 7230, sekcja 3.2.6: Komponenty wartości pola

Napraw

Sprawdź, czy żądanie HTTP klienta wysłane do Apigee Edge nie zawiera znaków spoza zestawu ASCII w nazwach nagłówków zgodnie z RFC 7230, sekcja 3.2.6: Komponenty wartości pola.

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ówna się (=), przecinek (,), średnik (;), tab, CRLF i znak nowego wiersza.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: pola nagłówka oraz RFC 7230, sekcja 3.2.6: Komponenty wartości pola

Napraw

Sprawdź, czy żądanie HTTP wysłane przez aplikację kliencką do Apigee Edge zawierają wszelkie nieprawidłowe znaki 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łanej przez aplikację kliencką do Apigee Edge zawiera znaki, które są 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

Sprawdź, czy ścieżka w adresie URL żądania HTTP wysłanego przez klienta aplikacji do Apigee Edge nie zawiera żadnych znaków, które są niedozwolone zgodnie z sekcją 3.3 standardu 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łanego przez aplikację kliencką w ramach Żądanie HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee dotyczące krawędzi
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ń wysłanych przez klienta aplikacji w ramach żądania HTTP wysyłanego do Apigee Edge jest większa niż dozwolona w Apigee Edge.
  • Specyfikacja HTTP:
 RFC 6585, sekcja 5: 431 Pole nagłówka żądania za duże
  • Limity:
 Limity brzegowe 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 wysłanego przez aplikację kliencką jako część żądania HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge
  • Limity:
 Limity Apigee dotyczące krawędzi
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 ponieważ część odpowiedzi HTTP zawiera format kodowania/ładunku, który nie jest obsługiwane 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 atrybut zmienna przepływu target.url zawiera ścieżkę rozpoczynającą się od znaku zapytania (?) zamiast ukośnika (/), 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, jeśli konkretny nagłówek HTTP nie może mieć duplikatów w Apigee Edge pojawia się więcej niż raz z tymi samymi lub różnymi wartościami w ramach parametru odpowiedź HTTP wysłana 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 żądania HTTP odpowiedź na Apigee Edge jest pusta.
  • Specyfikacja HTTP:
 RFC 7230, sekcja 3.2: pola nagłówka

Napraw

Sprawdź, czy odpowiedź HTTP wysłana przez backend z serwera Apigee Edge zawsze zawiera prawidłową nazwę nagłówka, taką jak RFC 7230, sekcja 3.2: Header Fields (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 zmienna przepływu target.url zawiera pustą ścieżkę.
  • Specyfikacja HTTP:

RFC 3986, sekcja 3: komponenty składni oraz 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 odpowiedź HTTP do Apigee Edge zawiera znaki spoza zestawu ASCII.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: Header Fields oraz RFC 7230, sekcja 3.2.6: Komponenty wartości pola

Napraw

Sprawdź, czy odpowiedź HTTP serwera backendu wysyłana do Apigee Edge nie zawiera znaków spoza zestawu ASCII w nazwach nagłówków 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ówna się (=), przecinek (,), średnik (;), tab, CRLF i znak nowego wiersza.
  • Specyfikacja HTTP:

RFC 7230, sekcja 3.2: pola nagłówka oraz RFC 7230, sekcja 3.2.6: Komponenty wartości pola

Napraw

Sprawdź, czy odpowiedź HTTP serwera backendu wysłana do Apigee Edge nie zawiera żadnych nieprawidłowe znaki 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 serwer backendu przez serwer proxy z powodu zapory sieciowej, listy kontroli dostępu (ACL) i DNS problemy, dostępność serwera backendu itp.

Uwaga: kod stanu w komunikacie o błędzie (faultstring) podaje główną 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 306 kod stanu do Apigee Edge.

Kod stanu 306 został zdefiniowany w poprzedniej wersji Specyfikacja HTTP. Zgodnie z bieżącą specyfikacją HTTP ten kod jest jest zarezerwowana i nie należy jej używać.
  • Specyfikacja HTTP:
 RFC 7231, sekcja 6.3.5: 306 zarezerwowane

Napraw

Ponieważ kod stanu 306 jest zarezerwowany, upewnij się, że: serwer backendu nie używa tego kodu stanu podczas wysyłania odpowiedź 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 Kod stanu 405 Method Not Allowed bez nagłówka „Allow”.
  • Specyfikacja HTTP:

RFC 7231, sekcja 6.5.5: 405 Method Not Allowed 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 to 204 No Content albo 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 treści oraz RFC 7231, sekcja 6.3.6: 205 Resetowanie treści
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łanego przez aplikację kliencką w ramach Żądanie HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee dotyczące krawędzi
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, jeśli łączny rozmiar wszystkich nagłówków odpowiedzi wysyłanych przez Serwer backendu w odpowiedzi HTTP do Apigee Edge jest większy niż dozwolony limit w Apigee Edge.
  • Limity:
 Limity brzegowe 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 wysłanego przez serwer backendu jako część odpowiedzi HTTP do Apigee Edge przekracza dozwolony limit w Apigee Edge.
  • Limity:
 Limity Apigee dotyczące krawędzi
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 jako część odpowiedzi HTTP zawiera kodowanie/ładunek w formacie innym niż obsługiwane 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 konkretny alias klucza, do którego odwołuje się docelowy punkt końcowy, występuje lub serwera docelowego nie udało się znaleźć w konkretnym magazynie kluczy.

Napraw

Sprawdź, czy alias klucza określony w elemencie TargetEndpoint lub TargetServer 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 konkretny 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żyć magazynu zaufania w punkcie końcowym lub serwerze docelowym, upewnić się, że magazyn zaufania zawiera prawidłowe certyfikaty serwera backendu.