502 Gateway non valido - DecompressionFailureAtResponse

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Sintomo

L'applicazione client riceve un codice di stato HTTP 502 Bad Gateway con codice di errore messaging.adaptors.http.flow.DecompressionFailureAtResponse come risposta alle chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 502 Bad Gateway

Inoltre, potresti visualizzare un messaggio di errore simile a quello mostrato di seguito:

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

Possibili cause

Questo errore si verifica solo se:

• La codifica specificata nell'intestazione della risposta HTTP (dal server di backend/di destinazione) Content-Encoding è valida e supportata da Apigee Edge,

MA

• Il formato del payload inviato dal server di backend/di destinazione come parte della risposta HTTP non corrisponde al formato di codifica specificato nell'intestazione Content-Encoding

Ciò accade perché Apigee Edge non riesce a decodificare il payload utilizzando la codifica specificata, in quanto il formato del payload non è lo stesso della codifica specificata nell'intestazione Content-Encoding.

Ecco alcuni esempi di valori di Content-Encoding supportati e di come Apigee Edge si aspetta che la rappresentazione del payload sia in questi casi:

Le possibili cause di questo errore sono le seguenti:

Passaggi di diagnostica comuni

Utilizza uno dei seguenti strumenti/tecniche per diagnosticare questo errore:

Causa: il formato del payload della risposta non corrisponde a Content-Encoding

Per impostazione predefinita, Apigee Edge decomprime sempre il payload se l'intestazione della risposta Content-Encoding contiene una codifica valida e supportata. Pertanto, è previsto che il formato del payload della risposta corrisponda alla codifica specificata nell'intestazione della risposta Content-Encoding. In caso di mancata corrispondenza, viene visualizzato questo errore.

Diagnosi

1. Determina il codice di errore e l'origine dell'errore osservato utilizzando il monitoraggio API, lo strumento Trace o i log di accesso NGINX, come spiegato in Passaggi comuni per la diagnosi.
2. Se il codice di errore è messaging.adaptors.http.flow.DecompressionFailureAtResponse e l'origine errore ha il valore target, significa che il formato del payload della risposta inviato dal server di backend/di destinazione non corrisponde alla codifica supportata specificata nell'intestazione della risposta Content-Encoding.

3. Puoi determinare la mancata corrispondenza come parte della risposta HTTP utilizzando uno dei seguenti metodi:

   Messaggio di errore

   Per la convalida tramite il messaggio di errore:

   1. Se hai accesso al messaggio di errore completo ricevuto da Apigee Edge, fai riferimento a faultstring.

      Messaggio di errore di esempio:

      "faultstring":"Decompression failure at response"

   2. Nel messaggio di errore precedente, viene visualizzato "Decompression failure at response", il che implica che la risposta non è stato possibile decomprimerla utilizzando la codifica specificata nell'intestazione Content-Encoding.

   Traccia

   Per convalidare utilizzando Trace:

   1. Determina Content-Type e error.cause utilizzando Trace come spiegato in Passaggi comuni per la diagnosi.

   2. I valori della traccia di esempio sono i seguenti:

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

      Il valore nell'intestazione della risposta Content-Encoding è gzip; tuttavia, il payload della risposta non è in formato GZIP (come indicato da error.cause). Pertanto, Apigee Edge risponde con 502 Bad Gateway e il codice di errore messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Richiesta effettiva

   Per convalidare utilizzando la richiesta effettiva:

   Se hai accesso alla richiesta effettiva inviata all'applicazione server di destinazione/di backend, segui questi passaggi:

   1. Se sei un utente di cloud pubblico/cloud privato, invia una richiesta direttamente al server di backend dal server di backend stesso o da qualsiasi altro computer da cui ti è consentito inviare la richiesta al server di backend.
   2. Se sei un utente di Private Cloud, puoi anche inviare la richiesta al server di backend da uno dei Message Processor.
   3. Esamina la risposta inviata dal server di backend e determina il valore trasmesso nell'intestazione della risposta Content-Encoding.
   4. Determina il formato del payload inviato nell'ambito della richiesta.
   5. Se il valore dell'intestazione Content-Encoding è nell'elenco della codifica supportata, ma il formato del payload della risposta non corrisponde alla codifica specificata nell'intestazione Content-Encoding, allora questa è la causa del problema.

      Esempio:

      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)>
      

      La risposta di esempio riportata sopra invia il valore gzip all'intestazione Content-Encoding, che è una codifica supportata in Apigee Edge. Tuttavia, il response_payload.zip viene inviato come file ZIP. Pertanto, questa risposta non va a buon fine e restituisce un errore 502 Bad Gateway con il codice di errore: messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Log del processore di messaggi

   Per la convalida utilizzando i log del processore di messaggi:

   Se sei un utente di Private Cloud, puoi utilizzare i log del processore di messaggi per determinare le informazioni chiave sugli errori HTTP 502.

   1. Controlla il log del processore di messaggi:

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

   2. Cerca se si sono verificati errori 502 durante un periodo di tempo specifico (se il problema si è verificato in passato) o se alcune risposte continuano a non riuscire con 502. Puoi utilizzare la seguente stringa di ricerca:

      grep -ri "ZipException"
      

   3. Troverai righe di system.log simili alle seguenti:

      Scenario 1

      Scenario 1: quando la risposta dell'API ha l'intestazione Content-Encoding: gzip

      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
      

      La riga java.util.zip.ZipException: Not in GZIP format nel messaggio di errore riportato sopra indica che il payload della risposta non viene inviato in formato GZIP, anche se Content-Encoding è specificato come gzip. Pertanto, Apigee Edge genera l'eccezione e restituisce un codice di stato 502 con codice di errore messaging.adaptors.http.flow.DecompressionFailureAtResponse alle applicazioni client.

      Scenario 2

      Scenario 2: quando la risposta dell'API ha l'intestazione Content-Encoding: deflate

      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
      
      

      Le righe java.util.zip.ZipException: incorrect header check e Caused by: java.util.zip.DataFormatException: incorrect header check nel messaggio di errore riportato sopra indicano che il payload della risposta non viene inviato in formato deflate e non corrisponde alla codifica specificata nell'intestazione Content-Encoding di deflate. Pertanto, Apigee Edge genera l'eccezione e restituisce un codice di stato 502 con il codice di errore messaging.adaptors.http.flow.DecompressionFailureAtResponse alle applicazioni client.

Risoluzione

1. Se non è necessario il payload della risposta compressa nel flusso del proxy API in Apigee Edge e nel server di backend, non passare l'intestazione Content-Encoding. Se è necessario comprimere il payload della risposta, vai al passaggio 2.
2. Se è necessario comprimere il payload della risposta, assicurati che il server di backend invii sempre quanto segue:
   • Una qualsiasi delle codifiche supportate come valore dell'intestazione Content-Encoding nella risposta
   • Il payload della risposta nel formato supportato per Apigee Edge corrisponde al formato di codifica specificato nell'intestazione Content-Encoding.
3. Nell'esempio discusso sopra, il payload della risposta è in formato ZIP, ma l'intestazione della risposta specifica Content-Encoding: gzip. Puoi risolvere il problema inviando l'intestazione della risposta come Content-Encoding: gzip e il payload della risposta in formato gzip:

   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)>
   

Specifica

Apigee Edge risponde con il codice di stato 502 Bad Gateway con codice di errore messaging.adaptors.http.flow.DecompressionFailureAtResponse in base alle seguenti specifiche RFC:

Se hai ancora bisogno di assistenza da parte dell'assistenza Apigee, vai a Informazioni di diagnostica da raccogliere.

Deve raccogliere informazioni diagnostiche

Raccogli le seguenti informazioni diagnostiche e poi contatta l'assistenza Apigee Edge:

Se sei un utente del cloud pubblico, fornisci le seguenti informazioni:

• Nome organizzazione
• Nome ambiente
• Nome del proxy API
• Comando curl completo utilizzato per riprodurre l'errore 502
• File di traccia per le risposte API

Se sei un utente di Private Cloud, fornisci le seguenti informazioni:

• Messaggio di errore completo osservato per le risposte non riuscite
• Nome ambiente
• Bundle proxy API
• File di traccia per le risposte API

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

  Dove: ORG, ENV e PORT# vengono sostituiti con i valori effettivi.

• Log di sistema del processore di messaggi /opt/apigee/var/log/edge-message-processor/logs/system.log