502 Bad Gateway – DekomprimierungionFailureAtResponse

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

Symptom

Die Clientanwendung ruft den HTTP-Statuscode 502 Bad Gateway mit Fehlercode ab messaging.adaptors.http.flow.DecompressionFailureAtResponse als Antwort auf die API Anrufe.

Fehlermeldung

Die Clientanwendung ruft den folgenden Antwortcode ab:

HTTP/1.1 502 Bad Gateway

Außerdem kann eine Fehlermeldung wie die folgende angezeigt werden:

{
   "fault":{
      "faultstring":"Decompression failure at response",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"
      }
   }
}

Mögliche Ursachen

Dieser Fehler tritt nur in folgenden Fällen auf:

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

ABER

• Das Nutzlastformat, das vom Back-End/Zielserver als Teil der HTTP-Antwort gesendet wird nicht Entspricht dem im Header Content-Encoding angegebenen Codierungsformat

Dies liegt daran, dass Apigee Edge die Nutzlast nicht mit der angegebenen Codierung decodieren kann, da die Format der Nutzlast nicht dasselbe Format wie die im Content-Encoding-Header.

Hier sind einige Beispiele für unterstützte Content-Encoding-Werte und wie Apigee Edge erwartet die Nutzlastdarstellung in diesen Fällen:

Mögliche Ursachen für diesen Fehler:

Allgemeine Diagnoseschritte

Verwenden Sie eines der folgenden Tools oder Techniken, um diesen Fehler zu diagnostizieren:

Ursache: Antwortnutzlastformat stimmt nicht mit Content-Encoding überein.

Standardmäßig dekomprimiert Apigee Edge die Nutzlast, wenn der Antwortheader Content-Encoding enthält einen gültigen und einen <ph type="x-smartling-placeholder"></ph> unterstützte Codierung. Daher wird erwartet, dass das Format der Antwortnutzlast muss mit der Codierung übereinstimmen, die im Antwortheader Content-Encoding angegeben ist. Bei einer Abweichung wird dieser Fehler angezeigt.

Diagnose

1. Ermitteln Sie den Fehlercode und die Fehlerquelle für den mit der API beobachteten Fehler. Monitoring-, Trace-Tool- oder NGINX-Zugriffslogs wie unter Häufige Diagnoseschritte.
2. Wenn der Fehlercode messaging.adaptors.http.flow.DecompressionFailureAtResponse und die Fehlerquelle den Wert target hat, dann ist dies gibt an, dass das Format der vom Back-End/Zielserver gesendeten Antwortnutzlast nicht mit dem <ph type="x-smartling-placeholder"></ph> unterstützte Codierung im Antwortheader Content-Encoding.

3. Sie können die Abweichung als Teil der HTTP-Antwort mit einer der folgenden Methoden ermitteln: Methoden:

   Fehlermeldung

   So führen Sie eine Validierung mithilfe der Fehlermeldung durch:

   1. Wenn Sie Zugriff auf die vollständige Fehlermeldung von Apigee Edge haben, dann Weitere Informationen finden Sie im faultstring.

      Beispiel für eine Fehlermeldung:

      "faultstring":"Decompression failure at response"

   2. In der obigen Fehlermeldung wird "Decompression failure at response", was impliziert, dass die Antwort konnte nicht mit der in der angegebenen Codierung dekomprimiert werden. Content-Encoding-Header.

   Trace

   So validieren Sie mit Trace:

   1. Bestimmen Sie Content-Type und error.cause. mit Trace wie unter Häufige Diagnoseschritte erläutert.

   2. Die Werte aus dem Beispiel-Trace lauten wie folgt:

      • Content-Encoding: gzip
      • error.cause: Not in GZIP format

      Der Wert im Antwortheader Content-Encoding lautet gzip. Die Nutzlast der Antwort liegt jedoch nicht im GZIP-Format vor. (wie durch error.cause angegeben). Daher antwortet Apigee Edge mit 502 Bad Gateway und Fehlercode messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Tatsächliche Anfrage

   So validieren Sie die Anfrage anhand der tatsächlichen Anfrage:

   Wenn Sie Zugriff auf die eigentliche Anfrage an den Ziel-/Back-End-Server haben Anwendung und führen Sie dann die folgenden Schritte aus:

   1. Wenn Sie ein Nutzer einer öffentlichen Cloud/Private Cloud sind, stellen Sie eine Anfrage direkt zum Back-End-Server vom Back-End-Server selbst oder einem anderen Maschine, von der aus Sie die Anfrage an den Back-End-Server senden dürfen.
   2. Als Private Cloud-Nutzer können Sie die Anfrage auch stellen. von einem der Message Processor an den Backend-Server.
   3. Untersuchen Sie die vom Back-End-Server gesendete Antwort und bestimmen Sie den Wert. übergeben im Antwortheader Content-Encoding.
   4. Bestimmen Sie das Format der Nutzlast, die als Teil der Anfrage gesendet wird.
   5. Wenn der Wert des Headers Content-Encoding in der Liste der <ph type="x-smartling-placeholder"></ph> unterstützte Codierung, aber das Format der Antwortnutzlast stimmt nicht mit der im Content-Encoding-Header angegebenen Codierung überein, dann ist das die Ursache des Problems.

      Beispiel:

      curl -v https://HOSTALIAS/test
      

      ***trimmed***
      >
      < HTTP/1.1 200 OK
      < Accept-Ranges: bytes
      < Content-Encoding: gzip
      < Date: Mon, 02 Aug 2021 08:17:35 GMT
      < Transfer-Encoding: chunked
      <
      < response_payload.zip Response Body(not in GZIP format)>
      

      Mit der obigen Beispielantwort wird der Wert gzip an den Content-Encoding-Header, der eine <ph type="x-smartling-placeholder"></ph> unterstützte Codierung in Apigee Edge. Die response_payload.zip wird als ZIP-Datei gesendet. Daher ist dieser Antwort schlägt mit dem Fehler 502 Bad Gateway mit dem Fehlercode fehl: messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Message Processor-Logs

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

   So validieren Sie mit Message Processor-Logs:

   Wenn Sie ein Private Cloud-Nutzer sind, können Sie Message Processor-Logs verwenden. um die wichtigsten Informationen zu HTTP-502-Fehlern zu ermitteln.

   1. Überprüfen Sie das Message Processor-Protokoll:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   2. Suchen Sie nach 502-Fehlern während eines bestimmten Dauer (wenn das Problem in der Vergangenheit aufgetreten ist) oder ob es Antworten schlagen immer noch mit 502 fehl. Sie können den folgenden Suchstring verwenden:

      grep -ri "ZipException"
      

   3. Zeilen aus system.log sehen in etwa so aus:

      Szenario 1

      Szenario 1: Wenn die API-Antwort den Header „Content-Encoding: gzip“ enthält

      2021-08-02 06:50:25,433  NIOThread@2 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :  ClientInputChannel(ClientChannel[Connected:
      Remote:3.8.1.1:9000 Local:10.0.115.32:41298]@38140 useCount=1 bytesRead=0
      bytesWritten=203 age=469ms  lastIO=0ms  isOpen=true).onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      ---trimmed--
      2021-08-02 06:50:25,433  NIOThread@2 INFO  HTTP.CLIENT -
      HTTPClient$Context.logContextDetails() : Request details : host=null
      path=/folder/testFile method=GET. Channel details : Bytes read=0
      2021-08-02 06:50:25,434  NIOThread@2 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError(HTTPResponse@4806fdab, Not in GZIP format)
      2021-08-02 06:50:25,434  NIOThread@2 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception
      java.util.zip.ZipException: Not in GZIP format
      occurred while writing to channel null
      2021-08-02 06:50:25,434  NIOThread@2 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: Not in GZIP format
      

      Die Zeile java.util.zip.ZipException: Not in GZIP format in der obigen Fehlermeldung gibt an, dass die Antwort wird nicht im GZIP-Format gesendet, obwohl die Content-Encoding als gzip angegeben. Daher wirft Apigee Edge die Ausnahme und gibt einen 502-Statuscode mit Fehlercode zurück messaging.adaptors.http.flow.DecompressionFailureAtResponse Client-Anwendungen.

      Szenario 2

      Szenario 2: Wenn die API-Antwort den Header „Content-Encoding: deflate“ enthält

      2021-08-02 06:35:21,215  NIOThread@0 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :  ClientInputChannel(ClientChannel[Connected:
      Remote:3.8.1.1:9000 Local:192.168.194.140:35224]@36014 useCount=1 bytesRead=0
      bytesWritten=202 age=439ms  lastIO=2ms  isOpen=true).onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
      ---trimmed----
      Caused by:
      java.util.zip.DataFormatException: incorrect header check
      ---trimmed---
      2021-08-02 06:35:21,215  NIOThread@0 INFO  HTTP.CLIENT -
      HTTPClient$Context.logContextDetails() : Request details :
      host=null path=/folder/testFile method=GET. Channel details : Bytes read=0
      2021-08-02 06:35:21,216  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError(HTTPResponse@3966e277,
      incorrect header check)
      2021-08-02 06:35:21,216  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception
      java.util.zip.ZipException: incorrect header check occurred while writing to channel null
      2021-08-02 06:35:21,217  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: incorrect header check
      
      

      Die Linien java.util.zip.ZipException: incorrect header check und Caused by: java.util.zip.DataFormatException: incorrect header check in der obigen Fehlermeldung darauf hinweisen, dass die Antwortnutzlast nicht im deflate-Format und entspricht nicht der im Content-Encoding-Header von deflate. Daher wird Apigee Edge löst die Ausnahme aus und gibt den Statuscode 502 mit Fehlercode messaging.adaptors.http.flow.DecompressionFailureAtResponse Client-Anwendungen.

Auflösung

1. Wenn die komprimierte Antwortnutzlast im API-Proxy-Ablauf in Apigee Edge nicht benötigt wird und im Back-End-Server, dann übergeben Sie nicht den Header Content-Encoding. Wenn die Antwortnutzlast komprimiert werden muss, fahren Sie mit Schritt 2 fort.
2. Wenn die Antwortnutzlast komprimiert werden muss, prüfen Sie, ob der Back-End-Server sendet immer Folgendes: <ph type="x-smartling-placeholder">
   </ph>
   • Alle <ph type="x-smartling-placeholder"></ph> unterstützte Codierung als Wert für den Content-Encoding-Header in der Antwort
   • Die Antwortnutzlast im unterstützten Format für Apigee Edge entspricht der Codierung Format, das im Content-Encoding-Header angegeben ist
3. Im oben beschriebenen Beispiel liegt die Antwortnutzlast im ZIP-Format vor, aber der Antwortheader gibt Content-Encoding: gzip an. Sie können das Problem beheben, indem Sie die Antwort senden den Header als Content-Encoding: gzip und die Antwortnutzlast in gzip Format:

   curl -v https://HOSTALIAS/v1/test
   

   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Encoding: gzip
   < Date: Mon, 02 Aug 2021 08:17:35 GMT
   < Transfer-Encoding: chunked
   <
   < response_payload.gz Response Body(in GZIP format)>
   

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

Spezifikation

Apigee Edge antwortet mit dem Statuscode 502 Bad Gateway und dem Fehlercode messaging.adaptors.http.flow.DecompressionFailureAtResponse gemäß folgenden RFC Spezifikationen:

Wenn Sie weitere Unterstützung vom Apigee-Support benötigen, rufen Sie auf. Diagnosedaten müssen erfasst werden.

Erfassen von Diagnoseinformationen erforderlich

Erfassen Sie die folgenden Diagnoseinformationen und wenden Sie sich an den Apigee Edge-Support:

Wenn Sie ein Public Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Name der Organisation
• Name der Umgebung
• API-Proxy-Name
• Vollständiger curl-Befehl zum Reproduzieren des 502-Fehlers
• Ablaufverfolgungsdatei für die API-Antworten

Wenn Sie ein Private Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Vollständige Fehlermeldung für fehlgeschlagene Antworten
• Name der Umgebung
• API-Proxy-Bundle
• Ablaufverfolgungsdatei für die API-Antworten

• NGINX-Zugriffslogs /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Wo:ORG, ENV und PORT# werden ersetzt durch tatsächliche Werte.

• Systemprotokolle des Message Processor /opt/apigee/var/log/edge-message-processor/logs/system.log