Catalogo di errori di runtime

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Errori in Apigee Edge

Quando le richieste API vengono effettuate tramite Apigee Edge, i router e i processori di messaggi di Apigee Edge oppure il backend i server possono restituire errori alle applicazioni client.

Errori dal processore di messaggi

Il processore di messaggi è il componente principale di Apigee Edge che elabora i criteri e interagisce con i server di backend. Può restituire errori se rileva problemi quali:

  • Problemi di connettività di rete, errori di handshake TLS, indisponibilità del server di backend. Mancata risposta durante la comunicazione con il server di backend
  • Errori durante l'esecuzione del criterio
  • Intestazioni HTTP non valide, codifica, percorso, mancata conformità alle specifiche HTTP, superiore a limiti del prodotto e così via:
    • Con una richiesta HTTP inviata dalle applicazioni client

      • OPPURE

    • Con risposta HTTP inviata dal server di backend
  • E molti altri ancora

Esempio di errore del processore di messaggi

Il processore di messaggi restituisce sempre un codice di stato HTTP seguito da un messaggio di errore insieme a un codice di errore in formato JSON come mostrato di seguito:

L'applicazione client riceve un codice di risposta come nell'esempio seguente: 

HTTP/1.1 414 Request-URI Too Long

Una risposta di errore del processore di messaggi appare nel seguente formato: 

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

Descrizione dei campi nella risposta di errore:

Campo Descrizione
faultstring Contiene il messaggio di errore che descrive la possibile causa dell'errore
errorcode Codice di errore (chiamato anche codice di errore) associato al errore

Catalogo degli errori di runtime

Questo catalogo degli errori fornisce tutte le informazioni necessarie sul runtime codici di errore (per errori non relativi ai criteri) che vengono restituiti dal messaggio Apigee Edge. Componente processore. Include le seguenti informazioni per ciascuno dei codici di errore:

  • Codice di stato HTTP
  • Messaggio di errore
  • Possibili cause dell'errore
  • Eventuali specifiche HTTP associate e/o limiti di prodotto
  • Playbook e video contenenti istruzioni per diagnosticare la causa dell'errore. soluzioni efficaci che puoi applicare per risolvere autonomamente l'errore (se disponibile)
  • Correzione che puoi applicare per risolvere autonomamente l'errore

Sono incluse le seguenti categorie di codici di errore:

Utilizza la casella Cerca qui sotto per filtrare la tabella in modo da visualizzare le informazioni citate in precedenza per ottenere uno specifico codice di errore. Puoi cercare il codice di stato o qualsiasi contenuto in qualsiasi campo nella tabella.

Codice di errore Descrizione Correggi

flow.*

flow.APITimedOut
  • Codice di stato HTTP:
 504 Gateway Timeout
  • Messaggio di errore:
 API timed out
  • Possibile causa:

Questo errore si verifica se:

  • Il server di backend non risponde entro il periodo di timeout configurato dalla proprietà api.timeout per il proxy API specifico.
  • Un criterio richiede molto tempo a causa di operazioni ad alta intensità di calcolo, o prestazioni scadenti.

Nota: questo playbook fornisce istruzioni per risolvere il problema relativo al codice di errore. messaging.adaptors.http.flow.GatewayTimeout; ma puoi usare lo stesso playbook per risolvere il codice di errore flow.APITimedOut.

GUIDA PRATICA

flow.SharedFlowNotFound
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Shared Flow {shared_flow_name} Not Found
  • Possibile causa:

Questo errore si verifica se il flusso condiviso specifico:

  • Non esiste

    • OPPURE

  • Esiste, ma non è stato eseguito il deployment
GUIDA PRATICA

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • Codice di stato HTTP:
 404 Not Found
  • Messaggio di errore:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari:

  1. Il proxy API specifico è:
    1. NON configurato per accettare richieste sul sito Host virtuale
    2. NON configurato per accettare richieste sul percorso specifico utilizzata nella richiesta
    3. il deployment NON è stato eseguito nell'ambiente specifico in cui stanno tentando di fare richieste API
    4. NON distribuito su uno o più processori di messaggi
  2. L'ambiente specifico in cui tenta di eseguire Le richieste API non vengono caricate su uno o più processori di messaggi
 GUIDA PRATICA
Questo errore può verificarsi anche se più host virtuali hanno lo stesso host alias e numero di porta. GUIDA PRATICA

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Decompression failure at request
  • Possibile causa:

Questo errore si verifica solo se:

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

    • MA

  • Il formato del payload inviato dal client come parte della comunicazione HTTP richiesta non corrisponde al formato di codifica specificato nella Intestazione Content-Encoding
GUIDA PRATICA

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Decompression failure at response
  • Possibile causa:

Questo errore si verifica solo se:

  • La codifica specificata nel campo L'intestazione della risposta HTTP Content-Encoding è valida e supportate da Apigee Edge,

    • MA

  • Il formato del payload inviato dal server di backend/destinazione come parte della risposta HTTP non corrisponde al formato di codifica specificato nella Intestazione Content-Encoding
GUIDA PRATICA

messaging.adaptors.http.flow.ErrorResponseCode
  • Codice di stato HTTP:
 500

GUIDA PRATICA

VIDEO

  • Messaggio di errore:
 Il messaggio di errore e il formato possono variare in base al server di backend implementazione.
  • Possibile causa:
 Questo errore si verifica se il server di backend risponde con uno stato il codice 500 in Apigee Edge.
  • Codice di stato HTTP:
 503

GUIDA PRATICA

VIDEO

  • Messaggio di errore:
 Il messaggio di errore e il formato possono variare in base al server di backend implementazione.
  • Possibile causa:
 Questo errore si verifica se il server di backend risponde con uno stato il codice 503 in Apigee Edge.
  • Codice di stato HTTP:
 504 GUIDA PRATICA
  • Messaggio di errore:
 Il messaggio di errore e il formato possono variare in base al server di backend implementazione.
  • Possibile causa:
 Questo errore si verifica se il server di backend risponde con uno stato il codice 504 in Apigee Edge.

Nota: il codice di errore messaging.adaptors.http.flow.ErrorResponseCode non viene restituito nel messaggio di errore inviato alle applicazioni client. Questo è perché questo codice di errore viene impostato da Apigee Edge ogni volta che il server di backend risponde con un errore e uno dei 4XX o 5XX codici di stato. Puoi visualizzare questo codice di errore in API Monitoring, log di accesso NGINX, o un database di analisi.

messaging.adaptors.http.flow.GatewayTimeout
  • Codice di stato HTTP:
 504 Gateway Timeout
  • Messaggio di errore:
 Gateway Timeout
  • Possibile causa:
 Questo errore si verifica se il server di backend non risponde al processore di messaggi Apigee Edge Periodo di timeout di I/O configurato sul processore di messaggi.
GUIDA PRATICA

messaging.adaptors.http.flow.LengthRequired
  • Codice di stato HTTP:
 411 Length Required
  • Messaggio di errore:
 'Content-Length' is missing
  • Possibile causa:

Questo errore si verifica se l'intestazione Content-Length non viene passata l'applicazione client come parte delle istruzioni HTTP POST e PUT inviate ad Apigee Edge.

Nota: le richieste che non soddisfano questa condizione non può essere acquisito nello strumento Trace, poiché il processore di messaggi esegue questa convalida in una fase iniziale, molto prima di elaborare la richiesta qualsiasi criterio nel proxy API.
  • Specifica HTTP:
 RFC Sezione 3.3.2: Content-Length

Correggi

Per correggere questo errore:

  1. Assicurati che l'applicazione client passi sempre l'intestazione Content-Length nell'ambito di HTTP POST e PUT richieste inviate ad Apigee Edge. Ad esempio:

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

  2. Anche se stai passando un payload vuoto con POST e PUT richieste, verifica che l'intestazione Hai superato il giorno Content-Length: 0. Ad esempio:

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

messaging.adaptors.http.flow.NoActiveTargets
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 The Service is temporarily unavailable
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari, se utilizzi TargetServer in Apigee Edge:

  1. La risoluzione DNS errata dell'host del server di backend da un server di autorizzazione personalizzato ha generato indirizzi IP errati che hanno portato a errori di connessione.
  2. Errori di timeout della connessione dovuti a:
    1. La limitazione del firewall sul server di backend impedisce con Apigee Edge la connessione al server di backend.
    2. Problemi di connettività di rete tra Apigee Edge e il server di backend.
  3. L'host specificato in TargetServer non è corretto o contiene caratteri indesiderati (ad esempio, uno spazio).

GUIDA PRATICA

VIDEO
Questo errore può verificarsi anche se i controlli di integrità configurati per monitorare l'integrità dei server di destinazione non riesce.

GUIDA PRATICA

VIDEO

messaging.adaptors.http.flow.RequestTimeOut
  • Codice di stato HTTP:
 408 Request Timeout
  • Messaggio di errore:
 Request timed out
  • Possibile causa:
 Questo errore si verifica se il processore di messaggi Apigee Edge non riceve e richiedere il payload dall'applicazione client Periodo di timeout di I/O configurato nel componente Processore di messaggi.

Correggi

Assicurati che l'applicazione client invii il payload della richiesta all'interno Periodo di timeout I/O configurato sul componente Processore di messaggi di Apigee Edge.

messaging.adaptors.http.flow.ServiceUnavailable
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 The Service is temporarily unavailable
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari:

  1. La risoluzione DNS errata del server di backend da un server di autorizzazione personalizzato ha generato indirizzi IP errati all'inizio agli errori di connessione.
  2. Errori di timeout della connessione dovuti a:
    1. La limitazione del firewall sul server di backend impedisce con Apigee Edge la connessione al server di backend.
    2. Problemi di connettività di rete tra Apigee Edge e di backend.
  3. L'host del server di destinazione specificato nell'endpoint di destinazione è non è corretto o contiene caratteri indesiderati (ad esempio lo spazio).

GUIDA PRATICA

Errore DNS:

VIDEO

Connettività di rete:

VIDEO
Questo errore può verificarsi anche se il server di backend chiude prematuramente connessione mentre il processore di messaggi sta ancora inviando il payload di richiesta di backend. GUIDA PRATICA

messaging.adaptors.http.flow.SslHandshakeFailed
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 SSL Handshake failed {error_message}
  • Possibile causa:

Questo errore si verifica durante il processo di handshake SSL tra la console Processore di messaggi e server di backend se:

  1. L'archivio attendibilità del processore di messaggi di Apigee Edge:
    • Contiene una catena di certificati che non corrisponde a quella del server di backend catena di certificati completa

      • OPPURE

    • Non contiene la catena di certificati completa del server di backend
  2. La catena di certificati presentata dal server di backend:
    • Contiene un nome di dominio completo (FQDN) che non corrisponde al il nome host specificato nell'endpoint di destinazione

      • OPPURE

    • Contiene una catena di certificati errata/incompleta

GUIDA PRATICA

VIDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Unexpected EOF at target
  • Possibile causa:

Questo errore si verifica in uno dei seguenti scenari:

  1. TargetServer non è configurato correttamente per supportare le connessioni TLS/SSL di Apigee Edge.
  2. Il server di backend potrebbe chiudere bruscamente la connessione, mentre Apigee Edge è in attesa di una risposta dal server di backend.
  3. Mantieni i timeout attivi configurati in modo errato su Apigee e di backend.
GUIDA PRATICA

messaging.runtime.*

messaging.runtime.RouteFailed
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Unable to route the message to a TargetEndpoint
  • Possibile causa:

Questo errore si verifica se Apigee Edge non può instradare la richiesta a uno TargetEndpoint perché:

  • Non esiste una condizione della regola di route (<RouteRule>) che corrisponde alla richiesta in un proxy

    • E

  • Nessuna regola di route predefinita definita nel ProxyEndpoint (ad es. <RouteRule> senza alcuna condizione)

Correggi

Per correggere questo errore:

  1. Rivedi le regole di route definite in ProxyEndpoint e modificale per assicurarti che è presente almeno una condizione della regola di route che corrisponde alla tua richiesta.
  2. È buona norma definire una regola di route predefinita senza condizioni quando ci sono più RouteRules.
  3. Assicurati che la regola di route predefinita sia sempre definita per ultima nell'elenco condizionali perché le regole vengono valutate dall'alto verso il basso nel ProxyEndpoint.

Per scoprire di più sulla definizione di condizioni <RouteRule> in un ProxyEndpoint, vedi Destinazioni condizionali.

messaging.runtime.SenseRaiseFault
  • Codice di stato HTTP:
 403 Forbidden
  • Messaggio di errore:
 Sense Fault
  • Possibile causa:
 Questo errore si verifica se viene effettuata una richiesta API da un determinato indirizzo IP client che è bloccato dalle regole Apigee Sense.

Correggi

Per correggere questo errore:

  1. Verifica di aver bloccato l'indirizzo IP del client specifico entro il giorno controllando le regole configurate in Apigee Sense. Se è bloccato, questo indica che funziona come previsto.
  2. Se l'indirizzo IP del client specifico non è bloccato, ma stai Quando ricevi questo errore, contatta l'assistenza Apigee Edge.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Bad Form Data
  • Possibile causa:

Questo errore si verifica solo se vengono soddisfatte tutte le seguenti condizioni:

  1. La richiesta HTTP inviata dal client ad Apigee Edge contiene:
    • Content-Type: application/x-www-form-urlencoded, e
    • Dati del modulo con il segno della percentuale (%) o la percentuale (%) seguito da caratteri esadecimali non validi che non sono consentiti secondo Moduli - Sezione 17.13.4.1.
  2. Il proxy API in Apigee Edge legge il modulo specifico che contengono caratteri non consentiti utilizzando ExtractVariables o il criterioAssignMessage nel flusso di richiesta.
GUIDA PRATICA

protocol.http.DuplicateHeader
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Duplicate Header "{header_name}"
  • Possibile causa:
 Questo errore si verifica se un'intestazione HTTP specifica non può avere duplicati in Apigee Edge, compare più di una volta con valori uguali o diversi nell'ambito Richiesta HTTP inviata dall'applicazione client ad Apigee Edge.
  • Specifica HTTP:
 RFC 7230, sezione 3.2.2: Ordine sul campo
GUIDA PRATICA

protocol.http.EmptyHeaderName
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Header name cannot be empty
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato come parte della comunicazione HTTP richiesta dall'applicazione client ad Apigee Edge è vuota.
  • Specifica HTTP:
 RFC 7230, sezione 3.2: campi intestazione

Correggi

Assicurati che la richiesta HTTP inviata dall'applicazione client ad Apigee Edge contiene sempre un nome di intestazione valido RFC 7230, sezione 3.2: campi intestazione.

protocol.http.HeaderNameWithNonAsciiChar
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Header {header_name} contains non ascii character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato come parte della richiesta HTTP dell'applicazione client ad Apigee Edge contiene caratteri non ASCII.
  • Specifica HTTP:

RFC 7230, sezione 3.2: Campi intestazione e . RFC 7230, sezione 3.2.6: Componenti del valore di campo

Correggi

Assicurati che la richiesta HTTP del client sia stata inviata Apigee Edge non contiene caratteri non ASCII nei nomi delle intestazioni, come RFC 7230, sezione 3.2.6: Componenti del valore dei campi.

protocol.http.HeaderWithInvalidChar
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Header {header_name} contains invalid character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato come parte della richiesta HTTP dall'applicazione client ad Apigee Edge, contiene caratteri non validi come uguale (=), virgola (,), punto e virgola (;), tab, CRLF e carattere di nuova riga.
  • Specifica HTTP:

RFC 7230, sezione 3.2: campi intestazione e . RFC 7230, sezione 3.2.6: Componenti del valore di campo

Correggi

Assicurati che la richiesta HTTP inviata dall'applicazione client ad Apigee Edge contenere qualsiasi carattere non valido nei nomi delle intestazioni, come RFC 7230, sezione 3.2.6: Componenti del valore dei campi

protocol.http.InvalidPath
  • Codice di stato HTTP:
 400 Bad Request
  • Messaggio di errore:
 Invalid path {path}
  • Possibile causa:
 Questo errore si verifica se il percorso nell'URL della richiesta HTTP inviato dall'applicazione client che contiene caratteri non consentiti in base alla specifica RFC 3986, sezione 3.3: Percorso.
  • Specifica HTTP:

RFC 3986, sezione 3: Componenti di sintassi e . RFC 3986, sezione 3.3: Percorso

Correggi

Assicurati che il percorso nell'URL della richiesta HTTP inviato dal client per l'applicazione Apigee Edge non contiene caratteri non consentiti secondo lo standard RFC 3986, sezione 3.3: Percorso.

protocol.http.TooBigBody
  • Codice di stato HTTP:
 413 Request Entity Too Large
  • Messaggio di errore:
 Body buffer overflow
  • Possibile causa:
 Questo errore si verifica se la dimensione del payload inviato dall'applicazione client nell'ambito La richiesta HTTP ad Apigee Edge è superiore al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.TooBigHeaders
  • Codice di stato HTTP:
 431 Request Header Fields Too Large
  • Messaggio di errore:
 request headers size exceeding {limit}
  • Possibile causa:
 La dimensione totale di tutte le intestazioni della richiesta inviate dal client nell'ambito della richiesta HTTP ad Apigee Edge, è maggiore del limite consentito in Apigee Edge.
  • Specifica HTTP:
 RFC 6585, section 5: 431 Campo intestazione della richiesta troppo grande
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.TooBigLine
  • Codice di stato HTTP:
 414 Request-URI Too Long
  • Messaggio di errore:
 request line size exceeding {limit}
  • Possibile causa:
 Questo errore si verifica se le dimensioni della riga di richiesta inviata dall'applicazione client nell'ambito della richiesta HTTP ad Apigee Edge, sia superiore al limite consentito in Apigee Edge
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.UnsupportedEncoding
  • Codice di stato HTTP:
 415 Unsupported Media
  • Messaggio di errore:
 Unsupported Encoding "{encoding}"
  • Possibile causa:
 Questo errore si verifica se l'intestazione Content-Encoding inviata dal client come parte della risposta HTTP contiene un formato di codifica/payload che non è supportate da Apigee Edge.
  • Specifica HTTP:
 RFC 7231, sezione 6.5.13: 415 Tipo di media non supportato
GUIDA PRATICA

protocol.http.* - Caused by target

protocol.http.BadPath
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Invalid request path
  • Possibile causa:
 Questo errore si verifica se l'URL della richiesta del server di backend, rappresentato dal la variabile di flusso target.url, contiene un percorso che inizia con un punto interrogativo (?) anziché una barra (/), che non è valida.
  • Specifica HTTP:

RFC 3986, sezione 3: Componenti di sintassi e . RFC 3986, sezione 3.3: Percorso
GUIDA PRATICA

protocol.http.DuplicateHeader
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Duplicate Header "{header_name}"
  • Possibile causa:
 Questo errore si verifica se l'intestazione HTTP specifica non può avere duplicati in Apigee Edge, compare più di una volta con valori uguali o diversi nell'ambito la risposta HTTP inviata dal server di backend ad Apigee Edge.
  • Specifica HTTP:
 RFC 7230, sezione 3.2.2: Ordine sul campo
GUIDA PRATICA

protocol.http.EmptyHeaderName
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Header name cannot be empty
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato dal server di backend nell'ambito della comunicazione HTTP la risposta ad Apigee Edge è vuota.
  • Specifica HTTP:
 RFC 7230, sezione 3.2: campi intestazione

Correggi

Assicurati che la risposta HTTP inviata dal backend ad Apigee Edge contiene sempre un nome di intestazione valido come RFC 7230, sezione 3.2: campi intestazione.

protocol.http.EmptyPath
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 Request path cannot be empty
  • Possibile causa:
 Questo errore si verifica se l'URL della richiesta HTTP del server di backend, rappresentato da la variabile di flusso target.url, contiene un percorso vuoto.
  • Specifica HTTP:

RFC 3986, sezione 3: componenti di sintassi e . RFC 3986, sezione 3.3: Percorso
GUIDA PRATICA

protocol.http.HeaderNameWithNonAsciiChar
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Header {header_name} contains non ascii character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato dal server di backend come parte la risposta HTTP ad Apigee Edge contiene caratteri non ASCII.
  • Specifica HTTP:

RFC 7230, sezione 3.2: Campi intestazione e . RFC 7230, sezione 3.2.6: Componenti del valore di campo

Correggi

Assicurati che la risposta HTTP del server di backend inviata a Apigee Edge non contiene caratteri non ASCII nei nomi delle intestazioni, come RFC 7230, sezione 3.2.6: Componenti del valore dei campi.

protocol.http.HeaderWithInvalidChar
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Header {header_name} contains invalid character {character}
  • Possibile causa:
 Questo errore si verifica se il nome dell'intestazione inviato dal server di backend come parte della risposta HTTP, contiene caratteri non validi come uguale (=), virgola (,), punto e virgola (;), tab, CRLF e Newline.
  • Specifica HTTP:

RFC 7230, sezione 3.2: campi intestazione e . RFC 7230, sezione 3.2.6: Componenti del valore di campo

Correggi

Assicurati che la risposta HTTP del server di backend inviata ad Apigee Edge non contenga caratteri non validi nei nomi delle intestazioni come da RFC 7230, sezione 3.2.6: Componenti del valore dei campi

protocol.http.ProxyTunnelCreationFailed
  • Codice di stato HTTP:
 503 Service Unavailable
  • Messaggio di errore:
 Proxy refused to create tunnel with response status {status code}
  • Possibile causa:

Questo errore si verifica durante la creazione del tunnel tra Apigee Edge e server di backend dal server proxy a causa di firewall, ACL (Access Control List), DNS problemi, disponibilità della disponibilità del server di backend ecc.

Nota: il codice di stato nel messaggio di errore (faultstring) indica la causa principale del problema.
GUIDA PRATICA

protocol.http.Response306Reserved
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Response Status code 306 is reserved, so can't be used.
  • Possibile causa:

Questo errore si verifica se il server di backend risponde con Codice di stato 306 per Apigee Edge.

Il codice di stato 306 è stato definito in una versione precedente di specifica HTTP. Secondo la specifica HTTP corrente, questo codice e non devono essere utilizzati.
  • Specifica HTTP:
 RFC 7231, sezione 6.3.5: 306 Riservato

Correggi

Poiché il codice di stato 306 è riservato, assicurati che server di backend non utilizza questo codice di stato durante l'invio di una risposta ad Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Received 405 Response without Allow Header
  • Possibile causa:
 Il server di backend risponde con Codice di stato 405 Method Not Allowed senza l'intestazione "Allow".
  • Specifica HTTP:

RFC 7231, sezione 6.5.5: 405 Method Not Allowed e . RFC 7231, sezione 7.4.1: Consenti
GUIDA PRATICA

protocol.http.ResponseWithBody
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Received {status_code} Response with message body
  • Possibile causa:

Questo errore si verifica se la risposta HTTP dal server di backend ad Apigee Edge 204 No Content o 205 Reset Content ma contiene le corpo della risposta e/o una o più delle seguenti intestazioni:

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

RFC 7231, sezione 6.3.5: 204 Nessun contenuto e . RFC 7231, sezione 6.3.6: 205 Reimposta contenuti
GUIDA PRATICA

protocol.http.TooBigBody
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 Body buffer overflow
  • Possibile causa:
 Questo errore si verifica se la dimensione del payload inviato dall'applicazione client nell'ambito La richiesta HTTP ad Apigee Edge è superiore al limite consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.TooBigHeaders
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 response headers size exceeding {limit}
  • Possibile causa:
 Questo errore si verifica se la dimensione totale di tutte le intestazioni di risposta inviate dal come parte della risposta HTTP ad Apigee Edge sia maggiore del consentito in Apigee Edge.
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.TooBigLine
  • Codice di stato HTTP:
 502 Bad Gateway
  • Messaggio di errore:
 response line size exceeding {limit}
  • Possibile causa:
 Questo errore si verifica se la dimensione della riga di risposta inviata dal server di backend come parte della risposta HTTP ad Apigee Edge è superiore al limite consentito in Apigee perimetrali.
  • Limiti:
 Limiti di Apigee Edge
GUIDA PRATICA

protocol.http.UnsupportedEncoding
  • Codice di stato HTTP:
 415 Unsupported Media
  • Messaggio di errore:
 Unsupported Encoding "{encoding}"
  • Possibile causa:
 Questo errore si verifica se l'intestazione Content-Encoding inviata dal il server di backend come parte della risposta HTTP contiene la codifica/payload che non è supportate da Apigee Edge.
  • Specifica HTTP:
 RFC 7231, sezione 6.5.13: 415 Tipo di media non supportato
GUIDA PRATICA

security.util.*

security.util.KeyAliasNotFound
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Possibile causa:

Questo errore si verifica se al Keyalias specifico viene fatto riferimento nel TargetEndpoint oppure TargetServer non trovato nell'archivio chiavi specifico.

Correggi

Assicurati che il KeyAlias specificato in TargetEndpoint o TargetServer esiste e fa parte dell'archivio chiavi specifico.

security.util.TrustStoreWithNoCertificates
  • Codice di stato HTTP:
 500 Internal Server Error
  • Messaggio di errore:
 TrustStore {truststore_name} has no certificates
  • Possibile causa:

Questo errore si verifica se l'archivio di attendibilità specifico a cui viene fatto riferimento nell'endpoint di destinazione o TargetServer non contiene certificati.

Correggi

Se vuoi convalidare il certificato del server di backend usare il truststore in un TargetEndpoint o TargetServer, verifica che l'archivio attendibilità contenga certificati validi del server di backend.