Quando le richieste API vengono effettuate tramite Apigee, i router e i processori di messaggi dei componenti Apigee o il backend
i server possono restituire errori alle applicazioni client.
Errori dal processore di messaggi
Il processore di messaggi è il componente principale di Apigee 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 504 Gateway Timeout
Una risposta di errore del processore di messaggi appare nel seguente formato:
Contiene il messaggio di errore che descrive la possibile causa dell'errore
errorcode
Codice di errore (chiamato anche codice di errore) associato al
errore
reason
Contiene un messaggio che indica la possibile causa dell'errore
Catalogo degli errori di runtime
Questo catalogo degli errori fornisce tutte le informazioni necessarie sul runtime
codici di errore (per errori diversi dai criteri) restituiti dal messaggio Apigee.
Componente processore. Include le seguenti informazioni per ciascuno dei codici di errore:
Codice di stato HTTP
Messaggio di errore
Motivo dell'errore (non tutti i messaggi di errore mostrano
reason)
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.
searchRicerca
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.
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:
La codifica specificata nell'intestazione della richiesta HTTP
Content-Encoding è valido e supportato da Apigee,
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
La codifica specificata nel campo
L'intestazione della risposta HTTP Content-Encoding è valida e
supportate da Apigee,
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
messaging.adaptors.http.flow.ErrorResponseCode
Codice di stato HTTP:
500
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.
Codice di stato HTTP:
503
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.
Codice di stato HTTP:
504
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.
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 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
o un database di analisi.
messaging.adaptors.http.flow.GatewayTimeout
Codice di stato HTTP:
504 Gateway Timeout
Messaggio di errore:
Gateway Timeout
Motivo:
TARGET_READ_TIMEOUT
Possibile causa:
Questo errore si verifica se il server di backend non risponde
al processore di messaggi Apigee all'interno
Periodo di timeout I/O configurato sul processore di messaggi.
messaging.adaptors.http.flow.LengthRequired
Codice di stato HTTP:
411 Length Required
Messaggio di errore:
'Content-Length' is missing
Motivo:
CLIENT_REQUEST_CONTENT_LENGTH_REQUIRED
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.
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.
Assicurati che l'applicazione client passi sempre l'intestazione
Content-Length nell'ambito di HTTP POST e
PUT richieste inviate ad Apigee. Ad esempio:
curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"
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
Motivo:
TARGET_HEALTHCHECK_CONNECT_TIMEOUT
TARGET_HEALTHCHECK_CONNECTION_REFUSED
TARGET_HEALTHCHECK_HTTPS_REQUEST_OVER_HTTP
TARGET_HEALTHCHECK_UNEXPECTED_EOF
Possibile causa:
Questo errore si verifica in uno dei seguenti scenari,
se utilizzi
TargetServer in Apigee:
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.
Errori di timeout della connessione dovuti a:
La limitazione del firewall sul server di backend impedisce
di connettersi ad Apigee dal server di backend.
Problemi di connettività di rete tra Apigee
e il server di backend.
L'host specificato in TargetServer non è corretto o
contiene caratteri indesiderati (ad esempio, uno spazio).
Questo errore può verificarsi anche se i controlli di integrità configurati per monitorare l'integrità
dei server di destinazione non riesce.
messaging.adaptors.http.flow.RequestTimeOut
Codice di stato HTTP:
408 Request Timeout
Messaggio di errore:
Request timed out
Motivo:
CLIENT_READ_TIMEOUT
Possibile causa:
Questo errore si verifica se il processore di messaggi Apigee non riceve
e richiedere il payload dall'applicazione client
Periodo di timeout di I/O configurato nel componente del processore di messaggi.
Correggi
Assicurati che l'applicazione client invii il payload della richiesta all'interno
Periodo di timeout I/O configurato sul componente del processore di messaggi di Apigee.
messaging.adaptors.http.flow.ServiceUnavailable
Codice di stato HTTP:
503 Service Unavailable
Messaggio di errore:
The Service is temporarily unavailable
Motivo:
TARGET_CONNECT_TIMEOUT
TARGET_WRITE_BROKEN_PIPE
TARGET_WRITE_CONNECTION_RESET_BY_PEER
TARGET_CONNECT_CONNECTION_REFUSED
Possibile causa:
Questo errore si verifica in uno dei seguenti scenari:
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.
Errori di timeout della connessione dovuti a:
La limitazione del firewall sul server di backend impedisce
di connettersi ad Apigee dal server di backend.
Problemi di connettività di rete tra Apigee e
di backend.
L'host del server di destinazione specificato nell'endpoint di destinazione è
non è corretto o contiene caratteri indesiderati (ad esempio lo spazio).
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.
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 le macchine virtuali
Processore di messaggi e server di backend se:
L'archivio attendibilità del processore di messaggi di Apigee:
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
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
Il server di backend rifiuta la versione TLS utilizzata da Apigee.
Ad esempio, se il server di backend accetta solo TLS versione 1.3, ma
server di destinazione sul lato Apigee abbia TLS 1.2 impostato nel
TLS Protocol (o non è impostata alcuna versione TLS, nel qual caso non è impostata la versione TLS)
Al momento Apigee non utilizzerà TLS 1.3 come versione predefinita),
connessione non riesce a causa di una mancata corrispondenza delle versioni del protocollo.
Questo errore si verifica in uno dei seguenti scenari:
TargetServer non è configurato correttamente per supportare le connessioni TLS/SSL
di Apigee.
Il server di backend potrebbe chiudere bruscamente la connessione,
mentre Apigee è in attesa di una risposta dal server di backend.
Mantieni i timeout attivi configurati in modo errato su Apigee e
di backend.
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 non può instradare la richiesta a uno dei
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:
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.
È buona norma definire una regola di route predefinita senza condizioni
quando ci sono più RouteRules.
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.
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:
La richiesta HTTP inviata dal client ad Apigee
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.
Il proxy API in Apigee legge il modulo specifico
che contengono caratteri non consentiti utilizzando i parametri
ExtractVariables o il criterioAssignMessage nel flusso di richiesta.
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, compare più di una volta con valori uguali o diversi nell'ambito
Richiesta HTTP inviata dall'applicazione client ad Apigee.
Questo errore si verifica se il nome dell'intestazione inviato come parte della comunicazione HTTP
richiesta dall'applicazione client ad Apigee è vuota.
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
dall'applicazione client ad Apigee contiene caratteri non ASCII.
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 contiene caratteri non validi come
uguale (=), virgola (,), punto e virgola (;), tab, CRLF e carattere di nuova riga.
Dove: {hostname} è dinamico e il suo valore
cambia rispetto al nome host specificato.
Motivo:
TARGET_CONNECT_HOST_NOT_REACHABLE
Possibile causa:
Questo errore si verifica se l'host del server di destinazione specificato
non è corretto o contiene caratteri indesiderati (ad esempio lo spazio).
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
ad Apigee contiene caratteri non consentiti in base alla specifica
RFC 3986, sezione 3.3: Percorso.
Questo errore si verifica se la dimensione del payload inviato dall'applicazione client nell'ambito
La richiesta HTTP ad Apigee è superiore al limite consentito in Apigee.
La dimensione totale di tutte le intestazioni della richiesta inviate dal client
nell'ambito della richiesta HTTP ad Apigee è maggiore del limite consentito
in Apigee.
Questo errore si verifica se la dimensione della riga di richiesta inviata dall'applicazione client
nell'ambito della richiesta HTTP ad Apigee è superiore al limite consentito in
Apigee.
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.
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.
Questo errore si verifica se l'intestazione HTTP specifica non può avere duplicati
in Apigee, compare più di una volta con valori uguali o diversi nell'ambito
la risposta HTTP inviata dal server di backend ad Apigee.
Questo errore si verifica se il nome dell'intestazione inviato dal server di backend nell'ambito della comunicazione HTTP
la risposta ad Apigee è vuota.
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.
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.
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.
Proxy refused to create tunnel with response status {status code}
Possibile causa:
Questo errore si verifica durante la creazione del tunnel tra Apigee e il
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.
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 ad Apigee.
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.
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.
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".
Questo errore si verifica se la risposta HTTP dal server di backend ad Apigee viene
204 No Content o
205 Reset Content ma contiene le
corpo della risposta e/o una o più delle seguenti intestazioni:
Questo errore si verifica se la dimensione del payload inviato dall'applicazione client nell'ambito
La richiesta HTTP ad Apigee è superiore al limite consentito in Apigee.
Questo errore si verifica se la dimensione totale di tutte le intestazioni di risposta inviate dal
come parte della risposta HTTP ad Apigee è maggiore del
consentito in Apigee.
Questo errore si verifica se la dimensione della riga di risposta inviata dal server di backend come
parte della risposta HTTP ad Apigee è superiore al limite consentito in Apigee
perimetrali.
Questo errore si verifica se l'intestazione Content-Encoding inviata dal
il server di backend come parte della risposta HTTP contiene la codifica/payload
non supportato da Apigee.
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.