Laufzeitfehlerkatalog

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

<ph type="x-smartling-placeholder">

Fehler in Apigee Edge

Wenn API-Anfragen über Apigee Edge, die Apigee Edge-Komponenten, Router und Nachrichtenprozessoren oder das Backend erfolgen Server können Fehler an die Client-Anwendungen zurückgeben.

Fehler vom Message Processor

Der Nachrichtenprozessor ist die Kernkomponente von Apigee Edge, die die Richtlinien und und mit den Back-End-Servern interagiert. Er kann Fehler zurückgeben, wenn folgende Probleme auftreten:

  • Probleme mit der Netzwerkverbindung, TLS-Handshake-Fehler, Nichtverfügbarkeit des Backend-Servers, fehlende Antwort während der Kommunikation mit dem Backend-Server
  • Fehler während der Ausführung der Richtlinie
  • Ungültige HTTP-Header, Codierung, Pfad, Nichteinhaltung von HTTP-Spezifikationen, Überschreitung von Produktlimits usw.:
    • Mit den von den Clientanwendungen gesendeten HTTP-Anfragen

      • OR

    • Mit der vom Backend-Server gesendeten HTTP-Antwort
  • Und vieles mehr

Beispielfehler vom Message Processor

Der Message Processor gibt immer einen HTTP-Statuscode gefolgt von einer Fehlermeldung sowie einem Fehlercode im JSON-Format zurück, wie unten gezeigt:

Die Clientanwendung erhält einen Antwortcode wie im folgenden Beispiel: 

HTTP/1.1 414 Request-URI Too Long

Eine Fehlermeldung des Message Processors wird im folgenden Format angezeigt: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}
 <ph type="x-smartling-placeholder">

Beschreibung der Felder in der Fehlerantwort:

Feld Beschreibung
faultstring Enthält die Fehlermeldung, die die mögliche Ursache für den Fehler beschreibt
errorcode Fehlercode, der mit dem Fehler verknüpft ist

Laufzeitfehlerkatalog

Dieser Fehlerkatalog bietet alle Informationen, die Sie über die Laufzeit Fehlercodes (für Nicht-Richtlinienfehler), die von der Apigee Edge-Nachricht zurückgegeben werden Prozessorkomponente. Sie enthält die folgenden Informationen zu den einzelnen Fehlercodes:

  • HTTP-Statuscode
  • Fehlermeldung
  • Mögliche Ursachen für den Fehler
  • Zugehörige HTTP-Spezifikationen und/oder Produkteinschränkungen
  • Playbooks und Videos, die Anleitungen zur Diagnose der Fehlerursache und effektive Lösungen enthalten, mit denen Sie den Fehler selbst beheben können (falls verfügbar)
  • Fehlerkorrektur, um den Fehler selbst zu beheben

Die folgenden Fehlercode-Kategorien werden behandelt:

Verwenden Sie das Feld Suchen unten, um die Tabelle so zu filtern, dass die obigen Informationen für einen bestimmten Fehlercode angezeigt werden. Sie können in jedem Feld der Tabelle nach dem Statuscode oder einem beliebigen Inhalt suchen.

Fehlercode Beschreibung Korrigieren

flow.*

flow.APITimedOut
  • HTTP-Statuscode:
 504 Gateway Timeout
  • Fehlermeldung:
 API timed out
  • Mögliche Ursache:

Dieser Fehler tritt in folgenden Fällen auf:

  • Der Backend-Server antwortet nicht innerhalb des Zeitlimits, das vom Attribut api.timeout für den jeweiligen API-Proxy konfiguriert wurde.
  • Eine Richtlinie dauert aufgrund rechenintensiver Vorgänge, hoher Last oder schlechter Leistung sehr lange.

Hinweis:In diesem Playbook finden Sie eine Anleitung zum Beheben des Fehlercodes. messaging.adaptors.http.flow.GatewayTimeout; Sie können jedoch dasselbe Playbook, um den Fehlercode flow.APITimedOut zu beheben.

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

flow.SharedFlowNotFound
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 Shared Flow {shared_flow_name} Not Found
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn der spezifische freigegebene Ablauf:

  • Nicht vorhanden

    • OR

  • Vorhanden, aber nicht bereitgestellt ist
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • HTTP-Statuscode:
 404 Not Found
  • Fehlermeldung:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Mögliche Ursache:

Dieser Fehler tritt in einem der folgenden Szenarien auf:

  1. Der spezifische API-Proxy lautet:
    1. NICHT so konfiguriert, dass sie Anfragen auf dem spezifischen Virtueller Host
    2. NICHT zum Akzeptieren von Anfragen unter dem spezifischen Pfad konfiguriert in der Anfrage verwendet
    3. NICHT in der spezifischen Umgebung bereitgestellt wird, in der Sie die die API-Anfragen
    4. NICHT auf einem oder mehreren Message Processorn bereitgestellt
  2. Die spezifische Umgebung, in der Sie Die API-Anfragen werden nicht in einen oder mehrere Message Processor geladen.
 <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK
Dieser Fehler kann auch auftreten, wenn mehrere virtuelle Hosts denselben Host haben Alias und Portnummer. <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • HTTP-Statuscode:
 400 Bad Request
  • Fehlermeldung:
 Decompression failure at request
  • Mögliche Ursache:

Dieser Fehler tritt nur in folgenden Fällen auf:

  • Die im HTTP-Anfrageheader angegebene Codierung Content-Encoding ist gültig und <ph type="x-smartling-placeholder"></ph> unterstützt von Apigee Edge,

    • ABER

  • Das Nutzlastformat, das vom Client als Teil der HTTP-Anfrage gesendet wird, stimmt nicht mit dem im Content-Encoding-Header angegebenen Codierungsformat überein
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Decompression failure at response
  • Mögliche Ursache:

Dieser Fehler tritt nur in folgenden Fällen auf:

  • Die im Back-End/Zielserver angegebene Codierung Der HTTP-Antwortheader Content-Encoding ist gültig und <ph type="x-smartling-placeholder"></ph> unterstützt von Apigee Edge,

    • ABER

  • Das vom Backend-/Zielserver als Teil der HTTP-Antwort gesendete Nutzlastformat entspricht nicht dem im Header Content-Encoding angegebenen Codierungsformat
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.adaptors.http.flow.ErrorResponseCode
  • HTTP-Statuscode:
 500

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO

  • Fehlermeldung:
 Die Fehlermeldung und das Format können je nach Implementierung des Backend-Servers variieren.
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Backend-Server den Status Code 500 für Apigee Edge.
  • HTTP-Statuscode:
 503

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO

  • Fehlermeldung:
 Die Fehlermeldung und das Format können je nach Implementierung des Backend-Servers variieren.
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Backend-Server den Status Code 503 für Apigee Edge.
  • HTTP-Statuscode:
 504 <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK
  • Fehlermeldung:
 Die Fehlermeldung und das Format können je nach Implementierung des Backend-Servers variieren.
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Backend-Server mit Status antwortet Code 504 für Apigee Edge.

Hinweis: Der Fehlercode messaging.adaptors.http.flow.ErrorResponseCode wird nicht als Teil der Fehlermeldung zurückgegeben, die an die Clientanwendungen gesendet wird. Dies ist da dieser Fehlercode von Apigee Edge festgelegt wird, wenn der Back-End-Server antwortet mit einem Fehler und einem der Werte 4XX oder 5XX Statuscodes an. Sie können diesen Fehlercode in API Monitoring, NGINX-Zugriffslogs oder Analysedatenbank.

messaging.adaptors.http.flow.GatewayTimeout
  • HTTP-Statuscode:
 504 Gateway Timeout
  • Fehlermeldung:
 Gateway Timeout
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Backend-Server nicht antwortet. an den Apigee Edge Message Processor <ph type="x-smartling-placeholder"></ph> E/A-Zeitüberschreitungsintervall, das im Message Processor konfiguriert wurde.
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.adaptors.http.flow.LengthRequired
  • HTTP-Statuscode:
 411 Length Required
  • Fehlermeldung:
 'Content-Length' is missing
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn der Content-Length-Header nicht von die Clientanwendung als Teil der HTTP POST und PUT an Apigee Edge gesendete Anfragen.

Hinweis: Die Anfragen, die wegen dieses Fehlers fehlschlagen, können mit dem Trace-Tool nicht erfasst werden, da der Message Processor diese Validierung in einer sehr frühen Phase durchführt, lange bevor die Anfrage verarbeitet und eine Richtlinie im API-Proxy ausgeführt wird.
  • HTTP-Spezifikation:
 RFC-Abschnitt 3.3.2: Inhaltslänge

Korrigieren

Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:

  1. Achten Sie darauf, dass die Clientanwendung immer den Header übergibt Content-Length als Teil des HTTP-POST und PUT-Anfragen an Apigee Edge gesendet. Beispiel:

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

  2. Auch wenn Sie eine leere Nutzlast mit POST- und PUT-Anfragen übergeben, müssen Sie darauf achten, dass der Header Content-Length: 0 übergeben wird. Beispiel:

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

messaging.adaptors.http.flow.NoActiveTargets
  • HTTP-Statuscode:
 503 Service Unavailable
  • Fehlermeldung:
 The Service is temporarily unavailable
  • Mögliche Ursache:

Dieser Fehler tritt in einem der folgenden Szenarien auf: wenn Sie <ph type="x-smartling-placeholder"></ph> TargetServer in Apigee Edge:

  1. Die falsche DNS-Auflösung des Backend-Serverhosts durch den benutzerdefinierten Autorisierungsserver hat zu fehlerhaften IP-Adressen geführt, die zu Verbindungsfehlern führt.
  2. Zeitüberschreitungsfehler bei der Verbindung aufgrund von:
    1. Firewall-Einschränkung auf dem Back-End-Server verhindert, Verbindung von Apigee Edge zum Backend-Server.
    2. Netzwerkverbindungsprobleme zwischen Apigee Edge und Back-End-Server.
  3. Der im TargetServer angegebene Host ist falsch oder enthält unerwünschte Zeichen (z. B. ein Leerzeichen).

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO
Dieser Fehler kann auch auftreten, wenn die Systemdiagnosen, die für das Monitoring der Systemdiagnose der Zielserver konfiguriert sind, fehlschlagen.

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO

messaging.adaptors.http.flow.RequestTimeOut
  • HTTP-Statuscode:
 408 Request Timeout
  • Fehlermeldung:
 Request timed out
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Apigee Edge-Nachrichtenprozessor das Objekt von der Clientanwendung für den <ph type="x-smartling-placeholder"></ph> E/A-Zeitlimit, das in der Message Processor-Komponente konfiguriert wurde.

Korrigieren

Achten Sie darauf, dass die Clientanwendung die Nutzlast der Anfrage innerhalb der <ph type="x-smartling-placeholder"></ph> E/A-Zeitlimit, das in der Message Processor-Komponente von Apigee Edge konfiguriert ist.

messaging.adaptors.http.flow.ServiceUnavailable
  • HTTP-Statuscode:
 503 Service Unavailable
  • Fehlermeldung:
 The Service is temporarily unavailable
  • Mögliche Ursache:

Dieser Fehler tritt in einem der folgenden Szenarien auf:

  1. Die falsche DNS-Auflösung des Backend-Serverhosts durch den benutzerdefinierten Autorisierungsserver hat zu fehlerhaften IP-Adressen geführt, die zu Verbindungsfehlern führt.
  2. Zeitüberschreitungsfehler bei der Verbindung aufgrund von:
    1. Firewall-Einschränkung auf dem Back-End-Server verhindert, Verbindung von Apigee Edge zum Backend-Server.
    2. Netzwerkverbindungsprobleme zwischen Apigee Edge und Back-End-Server.
  3. Der im Zielendpunkt angegebene Zielserverhost ist falsch oder enthält unerwünschte Zeichen (z. B. Leerzeichen).

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

DNS-Fehler:

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO

Netzwerkverbindung:

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO
Dieser Fehler kann auch auftreten, wenn der Backend-Server die Verbindung vorzeitig beendet, während der Message Processor weiterhin die Anfragenutzlast an den Backend-Server sendet. <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.adaptors.http.flow.SslHandshakeFailed
  • HTTP-Statuscode:
 503 Service Unavailable
  • Fehlermeldung:
 SSL Handshake failed {error_message}
  • Mögliche Ursache:

Dieser Fehler tritt während des SSL-Handshakes zwischen dem Message Processor und der Backend-Server, wenn:

  1. Der Truststore des Message Processor von Apigee Edge: <ph type="x-smartling-placeholder">
      </ph>
    • Enthält eine Zertifikatskette, die nicht mit der des Backend-Servers übereinstimmt vollständige Zertifikatskette

      • ODER

    • Enthält nicht die vollständige Zertifikatskette des Backend-Servers
  2. The certificate chain presented by the backend server:
    • Enthält einen vollständig qualifizierten Domainnamen (FQDN), der nicht mit dem im Zielendpunkt angegebenen Hostnamen übereinstimmt

      • OR

    • Enthält eine falsche/unvollständige Zertifikatskette

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> VIDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Unexpected EOF at target
  • Mögliche Ursache:

Dieser Fehler tritt in einem der folgenden Szenarien auf:

  1. <ph type="x-smartling-placeholder"></ph> TargetServer ist nicht ordnungsgemäß konfiguriert, um TLS/SSL-Verbindungen zu unterstützen. in Apigee Edge.
  2. Der Backend-Server schließt die Verbindung möglicherweise abrupt, während Apigee Edge auf eine Antwort vom Back-End-Server wartet.
  3. Behalten Sie auf Apigee und auf dem Backend-Server falsch konfigurierte Zeitüberschreitungen bei.
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

messaging.runtime.*

messaging.runtime.RouteFailed
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 Unable to route the message to a TargetEndpoint
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn Apigee Edge die Anfrage nicht an eine der Zielendpunkte, weil:

  • Es gibt keine Bedingung für eine Routingregel (<RouteRule>), die der Anfrage in einem Proxy entspricht

    • AND

  • Im ProxyEndpoint ist keine Standardroutingregel definiert, d. h. <RouteRule> ohne Bedingung

Korrigieren

So beheben Sie diesen Fehler:

  1. Prüfen Sie die in Ihrem ProxyEndpoint definierten Routingregeln und ändern Sie sie, um sicherzustellen, dass mindestens eine Bedingung der Routingregel vorhanden ist, die Ihrer Anfrage entspricht.
  2. Es empfiehlt sich, eine Standard-Routingregel ohne Bedingung zu definieren, wenn Sie mehrere RouteRules haben.
  3. Achten Sie darauf, dass die Standard-Routingregel als letzte in der Liste der bedingten Routen definiert ist, da die Regeln im ProxyEndpoint von oben nach unten ausgewertet werden.

Weitere Informationen zum Definieren von <RouteRule>-Bedingungen in einem ProxyEndpoint finden Sie unter Bedingte Ziele.

messaging.runtime.SenseRaiseFault
  • HTTP-Statuscode:
 403 Forbidden
  • Fehlermeldung:
 Sense Fault
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn eine API-Anfrage von einer bestimmten Client-IP-Adresse gesendet wird. Dies wird im Rahmen der Apigee Sense-Regeln blockiert.

Korrigieren

So beheben Sie diesen Fehler:

  1. Prüfen Sie, ob Sie die spezifische Client-IP-Adresse blockiert haben, indem Sie <ph type="x-smartling-placeholder"></ph> Überprüfen der in Apigee Sense konfigurierten Regeln Ist sie blockiert, bedeutet das, dass es wie vorgesehen funktioniert.
  2. Wenn die spezifische Client-IP-Adresse nicht blockiert ist, erhalten, dann wenden Sie sich an den Apigee Edge-Support.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 Bad Form Data
  • Mögliche Ursache:

Dieser Fehler tritt nur dann auf, wenn alle folgenden Bedingungen erfüllt sind:

  1. Die HTTP-Anfrage, die vom Client an Apigee Edge gesendet wird enthält: <ph type="x-smartling-placeholder">
      </ph>
    • Content-Type: application/x-www-form-urlencoded, und
    • Formulardaten mit dem Prozentzeichen (%) oder dem Prozentzeichen (%), gefolgt von ungültigen Hexadezimalzeichen, die nicht gemäß der Formulare – Abschnitt 17.13.4.1 zulässig sind.
  2. Der API-Proxy in Apigee Edge liest die spezifische Form Parameter, die Zeichen enthalten, die bei Verwendung des ExtractVariables oder dieAssignMessage-Richtlinie im Anforderungsablauf.
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.DuplicateHeader
  • HTTP-Statuscode:
 400 Bad Request
  • Fehlermeldung:
 Duplicate Header "{header_name}"
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn ein bestimmter HTTP-Header keine Duplikate enthalten darf. in Apigee Edge, erscheint mehr als einmal mit denselben oder unterschiedlichen Werten als Teil des HTTP-Anfrage, die von der Clientanwendung an Apigee Edge gesendet wird.
  • HTTP-Spezifikation:
 RFC 7230, Abschnitt 3.2.2: Feldreihenfolge
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.EmptyHeaderName
  • HTTP-Statuscode:
 400 Bad Request
  • Fehlermeldung:
 Header name cannot be empty
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Headername Anfrage der Clientanwendung an Apigee Edge ist leer.
  • HTTP-Spezifikation:
 RFC 7230, Abschnitt 3.2: Headerfelder

Korrigieren

Achten Sie darauf, dass die von der Clientanwendung gesendete HTTP-Anfrage zu Apigee Edge enthält immer einen gültigen Headernamen gemäß <ph type="x-smartling-placeholder"></ph> RFC 7230, Abschnitt 3.2: Headerfelder.

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP-Statuscode:
 400 Bad Request
  • Fehlermeldung:
 Header {header_name} contains non ascii character {character}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Headername, der als Teil der HTTP-Anfrage gesendet wird, von der Clientanwendung auf Apigee Edge enthält Nicht-ASCII-Zeichen.
  • HTTP-Spezifikation:

RFC 7230, Abschnitt 3.2: Header-Felder und RFC 7230, Abschnitt 3.2.6: Komponenten für Feldwerte

Korrigieren

Prüfen Sie, ob die HTTP-Anfrage des Clients an Apigee Edge enthält keine Nicht-ASCII-Zeichen in Headernamen gemäß <ph type="x-smartling-placeholder"></ph> RFC 7230, Abschnitt 3.2.6: Feldwertkomponenten.

protocol.http.HeaderWithInvalidChar
  • HTTP-Statuscode:
 400 Bad Request
  • Fehlermeldung:
 Header {header_name} contains invalid character {character}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Headername, der als Teil der HTTP-Anfrage gesendet wird, der Clientanwendung auf Apigee Edge enthält ungültige Zeichen wie Gleichheitszeichen (=), Komma (,), Semikolon (;), Tab, CRLF und Zeilenvorschubzeichen.
  • HTTP-Spezifikation:

RFC 7230, Abschnitt 3.2: Header-Felder und RFC 7230, Abschnitt 3.2.6: Komponenten für Feldwerte

Korrigieren

Achten Sie darauf, dass die von der Clientanwendung an Apigee Edge gesendete HTTP-Anfrage nicht ungültige Zeichen in Headernamen gemäß den <ph type="x-smartling-placeholder"></ph> RFC 7230, Abschnitt 3.2.6: Feldwertkomponenten

protocol.http.InvalidPath
  • HTTP-Statuscode:
 400 Bad Request
  • Fehlermeldung:
 Invalid path {path}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Pfad in der von der Clientanwendung gesendeten HTTP-Anfrage-URL zu Apigee Edge enthält Zeichen, die gemäß der Spezifikation nicht zulässig sind. RFC 3986, Abschnitt 3.3: Pfad.
  • HTTP-Spezifikation:

RFC 3986, Abschnitt 3: Syntaxkomponenten und RFC 3986, Abschnitt 3.3: Pfad

Korrigieren

Prüfen Sie, ob der Pfad in der vom Client gesendeten HTTP-Anfrage-URL Anwendung für Apigee Edge enthält keine Zeichen, die als <ph type="x-smartling-placeholder"></ph> gemäß RFC 3986, Abschnitt 3.3: Pfad.

protocol.http.TooBigBody
  • HTTP-Statuscode:
 413 Request Entity Too Large
  • Fehlermeldung:
 Body buffer overflow
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die Nutzlastgröße Die HTTP-Anfrage an Apigee Edge ist größer als das zulässige Limit in Apigee Edge.
  • Beschränkungen:
 Apigee Edge-Beschränkungen
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.TooBigHeaders
  • HTTP-Statuscode:
 431 Request Header Fields Too Large
  • Fehlermeldung:
 request headers size exceeding {limit}
  • Mögliche Ursache:
 Die Gesamtgröße aller vom Client gesendeten Anfrageheader Anwendung als Teil der HTTP-Anfrage an Apigee Edge ist größer als zulässig Limit in Apigee Edge.
  • HTTP-Spezifikation:
 RFC 6585, Abschnitt 5: 431 Anfrage-Headerfelder zu groß
  • Beschränkungen:
 <ph type="x-smartling-placeholder"></ph> Apigee Edge-Limits
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.TooBigLine
  • HTTP-Statuscode:
 414 Request-URI Too Long
  • Fehlermeldung:
 request line size exceeding {limit}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die Größe der von der Clientanwendung gesendeten Anforderungszeile im Rahmen der HTTP-Anfrage an Apigee Edge überschreitet das zulässige Limit in Apigee Edge
  • Beschränkungen:
 Apigee Edge-Beschränkungen
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.UnsupportedEncoding
  • HTTP-Statuscode:
 415 Unsupported Media
  • Fehlermeldung:
 Unsupported Encoding "{encoding}"
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der vom Client gesendete Content-Encoding-Header als Teil der HTTP-Antwort ein Codierungs-/Nutzlastformat enthält, das nicht <ph type="x-smartling-placeholder"></ph> unterstützt von Apigee Edge.
  • HTTP-Spezifikation:
 RFC 7231, Abschnitt 6.5.13: 415 Nicht unterstützter Medientyp
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.* - Caused by target

protocol.http.BadPath
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 Invalid request path
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die Anfrage-URL des Backend-Servers, die durch die Flussvariable target.url dargestellt wird, einen Pfad enthält, der mit einem Fragezeichen (?) anstelle eines Schrägstrichs (/) beginnt, was ungültig ist.
  • HTTP-Spezifikation:

RFC 3986, Abschnitt 3: Syntaxkomponenten und RFC 3986, Abschnitt 3.3: Pfad
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.DuplicateHeader
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Duplicate Header "{header_name}"
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der spezifische HTTP-Header keine Duplikate enthalten darf. in Apigee Edge, erscheint mehr als einmal mit denselben oder unterschiedlichen Werten als Teil eines die HTTP-Antwort, die vom Back-End-Server an Apigee Edge gesendet wurde.
  • HTTP-Spezifikation:
 RFC 7230, Abschnitt 3.2.2: Feldreihenfolge
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.EmptyHeaderName
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Header name cannot be empty
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Headername, der vom Backend-Server als Teil des HTTP- Antwort an Apigee Edge ist leer.
  • HTTP-Spezifikation:
 RFC 7230, Abschnitt 3.2: Headerfelder

Korrigieren

Achten Sie darauf, dass die vom Back-End gesendete HTTP-Antwort an Apigee Edge enthält immer einen gültigen Headernamen gemäß <ph type="x-smartling-placeholder"></ph> RFC 7230, Abschnitt 3.2: Headerfelder.

protocol.http.EmptyPath
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 Request path cannot be empty
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die HTTP-Anfrage-URL des Backend-Servers, dargestellt durch die Ablaufvariable target.url, einen leeren Pfad enthält.
  • HTTP-Spezifikation:

RFC 3986, Abschnitt 3: Syntaxkomponenten und RFC 3986, Abschnitt 3.3: Pfad
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Header {header_name} contains non ascii character {character}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Header-Name, der vom Backend-Server als Teil der HTTP-Antwort an Apigee Edge gesendet wurde, Nicht-ASCII-Zeichen enthält.
  • HTTP-Spezifikation:

RFC 7230, Abschnitt 3.2: Header-Felder und RFC 7230, Abschnitt 3.2.6: Komponenten für Feldwerte

Korrigieren

Stellen Sie sicher, dass die HTTP-Antwort des Back-End-Servers an Apigee Edge enthält keine Nicht-ASCII-Zeichen in Headernamen gemäß <ph type="x-smartling-placeholder"></ph> RFC 7230, Abschnitt 3.2.6: Feldwertkomponenten.

protocol.http.HeaderWithInvalidChar
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Header {header_name} contains invalid character {character}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der Headername, der vom Backend-Server als Teil der HTTP-Antwort gesendet wurde, ungültige Zeichen wie Gleich (=), Komma (,), Semikolon (;), Tab, CRLF und einen Zeilenumbruch enthält.
  • HTTP-Spezifikation:

RFC 7230, Abschnitt 3.2: Header-Felder und RFC 7230, Abschnitt 3.2.6: Komponenten für Feldwerte

Korrigieren

Achten Sie darauf, dass die an Apigee Edge gesendete HTTP-Antwort des Backend-Servers keine ungültige Zeichen in den Headernamen gemäß <ph type="x-smartling-placeholder"></ph> RFC 7230, Abschnitt 3.2.6: Feldwertkomponenten

protocol.http.ProxyTunnelCreationFailed
  • HTTP-Statuscode:
 503 Service Unavailable
  • Fehlermeldung:
 Proxy refused to create tunnel with response status {status code}
  • Mögliche Ursache:

Dieser Fehler tritt beim Erstellen des Tunnels zwischen Apigee Edge und dem Backend-Server durch den Proxyserver aufgrund von Firewall, ACL (Access Control List), DNS Probleme, Verfügbarkeit des Backend-Servers usw.

Hinweis: Der Statuscode in der Fehlermeldung (faultstring) stellt die allgemeine Ursache des Problems dar.
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.Response306Reserved
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Response Status code 306 is reserved, so can't be used.
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn der Backend-Server mit Statuscode 306 an Apigee Edge.

Der Statuscode 306 wurde in einer früheren Version der HTTP-Spezifikation definiert. Gemäß der aktuellen HTTP-Spezifikation ist dieser Code reserviert und sollte nicht verwendet werden.
  • HTTP-Spezifikation:
 RFC 7231, Abschnitt 6.3.5: 306 Reserviert

Korrigieren

Da der Statuscode 306 reserviert ist, achten Sie darauf, dass verwendet Ihr Backend-Server diesen Statuscode beim Senden einer Antwort auf Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Received 405 Response without Allow Header
  • Mögliche Ursache:
 Der Backend-Server antwortet mit dem Statuscode 405 Method Not Allowed ohne den Header „Allow”.
  • HTTP-Spezifikation:

<ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 6.5.5: 405 Method Not Allowed und <ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 7.4.1: Zulassen
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.ResponseWithBody
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Received {status_code} Response with message body
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn die HTTP-Antwort vom Backend-Server an Apigee Edge entweder 204 No Content oder 205 Reset Content, enthält aber den Antworttext und/oder mindestens einen der folgenden Header:

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

RFC 7231, Abschnitt 6.3.5: 204 Keine Inhalte und RFC 7231, Abschnitt 6.3.6: 205 Inhalte zurücksetzen
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.TooBigBody
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 Body buffer overflow
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die Nutzlastgröße Die HTTP-Anfrage an Apigee Edge ist größer als das zulässige Limit in Apigee Edge.
  • Beschränkungen:
 Apigee Edge-Beschränkungen
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.TooBigHeaders
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 response headers size exceeding {limit}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die Gesamtgröße aller Antwortheader als Teil der HTTP-Antwort an Apigee Edge größer ist als die zulässigen Grenzwerts in Apigee Edge.
  • Beschränkungen:
 <ph type="x-smartling-placeholder"></ph> Apigee Edge-Limits
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.TooBigLine
  • HTTP-Statuscode:
 502 Bad Gateway
  • Fehlermeldung:
 response line size exceeding {limit}
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn die Größe der vom Back-End-Server gesendeten Antwortzeile als Ein Teil der HTTP-Antwort an Apigee Edge ist größer als das in Apigee zulässige Limit Edge
  • Beschränkungen:
 Apigee Edge-Beschränkungen
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

protocol.http.UnsupportedEncoding
  • HTTP-Statuscode:
 415 Unsupported Media
  • Fehlermeldung:
 Unsupported Encoding "{encoding}"
  • Mögliche Ursache:
 Dieser Fehler tritt auf, wenn der vom Content-Encoding-Header gesendete als Teil der HTTP-Antwort die Codierung/Nutzlast enthält, das nicht dem <ph type="x-smartling-placeholder"></ph> unterstützt von Apigee Edge.
  • HTTP-Spezifikation:
 RFC 7231, Abschnitt 6.5.13: 415 Nicht unterstützter Medientyp
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> PLAYBOOK

security.util.*

security.util.KeyAliasNotFound
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn der spezifische KeyAlias, auf den im TargetEndpoint oder TargetServer verwiesen wird, nicht im spezifischen Keystore gefunden wird.

Korrigieren

Achten Sie darauf, dass der im TargetEndpoint oder TargetServer angegebene KeyAlias vorhanden ist und Teil des spezifischen Keystores ist.

security.util.TrustStoreWithNoCertificates
  • HTTP-Statuscode:
 500 Internal Server Error
  • Fehlermeldung:
 TrustStore {truststore_name} has no certificates
  • Mögliche Ursache:

Dieser Fehler tritt auf, wenn der Truststore, auf den im TargetEndpoint oder TargetServer verwiesen wird, keine Zertifikate enthält.

Korrigieren

Wenn Sie das Zertifikat des Backend-Servers validieren und den Truststore in einem TargetEndpoint oder TargetServer verwenden möchten, prüfen Sie, ob der Truststore die gültigen Zertifikate des Backend-Servers enthält.