400 Richiesta errata - DecompressionFailureAtRequest

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

Sintomo

L'applicazione client riceve un codice di stato HTTP 400 Bad Request con codice di errore messaging.adaptors.http.flow.DecompressionFailureAtRequest come risposta alle chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 400 Bad Request

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

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

Possibili cause

Questo errore si verifica solo se:

• La codifica specificata nell'intestazione della richiesta HTTP Content-Encoding è valida e supportata da Apigee Edge,

MA

• Il formato del payload inviato dal client come parte della richiesta 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 Content-Encoding supportati e come Apigee Edge si aspetta che il formato 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 richiesta non corrisponde alla codifica specificata nell'intestazione Content-Encoding

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

Diagnosi

1. Determina il codice di errore e l'origine dell'errore per l'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.DecompressionFailureAtRequest e l'origine errore ha il valore policy o proxy, significa che la richiesta inviata dall'applicazione client ha un payload che non corrisponde alla codifica supportata specificata nell'intestazione della richiesta Content-Encoding.

3. Puoi determinare la mancata corrispondenza come parte della richiesta 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 request"

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

   Traccia

   Per convalidare utilizzando Trace:

   1. Determina il valore dell'intestazione della richiesta Content-Encoding e della proprietà 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 richiesta Content-Encoding è gzip; tuttavia, il payload della richiesta non è in formato GZIP (come indicato da error.cause). Pertanto, Apigee Edge risponde con 400 Bad Request e il codice di errore messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   Richiesta effettiva

   Per convalidare utilizzando la richiesta effettiva:

   Se hai accesso alla richiesta effettiva effettuata dall'applicazione client, segui questi passaggi:

   1. Determina il valore passato all'intestazione della richiesta Content-Encoding.
   2. Determina il formato del payload inviato nell'ambito della richiesta.

   3. Se il valore dell'intestazione Content-Encoding è nell'elenco della codifica supportata, ma il formato del payload della richiesta non corrisponde alla codifica specificata nell'intestazione Content-Encoding, allora questa è la causa del problema.

      Richiesta di esempio:

      curl -v "http://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.zip
      

      La richiesta di esempio riportata sopra invia il valore gzip all'intestazione Content-Encoding, che è una codifica supportata in Apigee Edge. Tuttavia, il payload della richiesta request_payload.zip è in formato ZIP. Pertanto, questa richiesta non va a buon fine e restituisce il codice di stato 400 Bad Request e il codice di errore: messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   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 400.

   1. Determina l'ID messaggio della richiesta non riuscita utilizzando API Monitoring, lo strumento Trace o i log di accesso NGINX come spiegato in Passaggi comuni per la diagnosi.

   2. Cerca l'ID messaggio nel log del processore di messaggi:

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

   3. Verrà visualizzata una delle seguenti eccezioni:

      Scenario 1

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

      2021-07-28 10:21:16,861  NIOThread@0 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-57-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.80.234:44284]@28469 useCount=1 bytesRead=0
      bytesWritten=28764 age=2739893ms  lastIO=0ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      
      2021-07-28 10:21:16,862  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rt-57-1, exception:java.util.zip.ZipException: Not in GZIP format,
      context:Context@71ea5ac input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.80.234:44284]@28469 useCount=1
      bytesRead=0 bytesWritten=28764 age=2739894ms  lastIO=0ms  isOpen=true)
      2021-07-28 10:21:16,862  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() :
      Exception java.util.zip.ZipException: Not in GZIP format occurred while writing
      to channel null
      2021-07-28 10:21:16,863  NIOThread@0 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 richiesta 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 400 con codice di errore messaging.adaptors.http.flow.DecompressionFailureAtRequest alle applicazioni client.

      Scenario 2

      Scenario n. 2: quando la richiesta API ha l'intestazione Content-Encoding: deflate

      2021-07-28 15:26:31,893  NIOThread@1 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-47875-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.81.72:45954]@29276 useCount=1 bytesRead=0
      bytesWritten=37230 age=3498856ms  lastIO=1ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
                        ….
      Caused by: java.util.zip.DataFormatException: incorrect header check
             ..
      2021-07-28 15:26:31,894  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rrt-47875-1, exception:java.util.zip.ZipException:
      incorrect header check, context:Context@69b3ac45
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.81.72:45954]@29276
      useCount=1 byt	esRead=0 bytesWritten=37230 age=3498856ms
      lastIO=1ms  isOpen=true)
      

      Le righe java.util.zip.ZipException: incorrect header check e Caused by: java.util.zip.DataFormatException: incorrect header check nel messaggio di errore precedente indicano che il payload della richiesta 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 400 con il codice di errore messaging.adaptors.http.flow.DecompressionFailureAtRequest alle applicazioni client.

Risoluzione

1. Se non è necessario il payload della richiesta compresso 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 richiesta, vai al passaggio 2.
2. Assicurati che l'applicazione client invii sempre quanto segue:
   • Una qualsiasi delle codifiche supportate come valore dell'intestazione Content-Encoding nella richiesta
   • Il payload della richiesta nel formato supportato per Apigee Edge corrisponde al formato di codifica specificato nell'intestazione Content-Encoding
3. Nell'esempio discusso in precedenza, il payload della richiesta è in formato ZIP, ma l'intestazione della richiesta specifica Content-Encoding: gzip. Puoi risolvere il problema inviando l'intestazione della richiesta come Content-Encoding: gzip e il payload della richiesta anche in formato gzip:

   curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
   

Specifica

Apigee Edge risponde con il codice di stato 400 Bad Request con codice di errore messaging.adaptors.http.flow.DecompressionFailureAtRequest 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 400
• File di traccia per le richieste API

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

• Messaggio di errore completo osservato per le richieste non riuscite
• Nome ambiente
• Bundle proxy API
• File di traccia per le richieste 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