Quando le richieste API vengono effettuate tramite Apigee, i componenti Apigee, router e processori di messaggi, oppure i server di backend possono restituire errori alle applicazioni client.
Errori dal processore di messaggi
Il processore di messaggi è il componente fondamentale di Apigee che elabora i criteri e interagisce con i server di backend. Può restituire errori se rileva problemi come:
Problemi di connettività di rete, errori di handshake TLS, indisponibilità del server di backend, mancanza di risposta durante la comunicazione con il server di backend
Errori durante l'esecuzione dei criteri
Intestazioni HTTP, codifica, percorso, mancata conformità alle specifiche HTTP, superamento dei limiti di prodotto e così via non validi:
Con la richiesta HTTP inviata dalle applicazioni client
OR
Con la 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 simile all'esempio seguente:
HTTP/1.1 504 Gateway Timeout
Una risposta di errore da parte del processore di messaggi viene visualizzata nel seguente formato:
Contiene il messaggio che descrive la possibile causa dell'errore
errorcode
Codice di errore (chiamato anche codice di errore) associato all'errore
reason
Contiene un messaggio che indica il possibile motivo dell'errore.
Catalogo degli errori di runtime
Questo catalogo degli errori fornisce tutte le informazioni necessarie sui codici di errore di runtime (per gli errori non correlati ai criteri) restituiti dal componente del processore di messaggi Apigee. e include le seguenti informazioni per ciascuno dei codici di errore:
Codice di stato HTTP
Messaggio di errore
Causa dell'errore (non tutti i messaggi di errore mostrano reason)
Possibili cause dell'errore
Eventuali specifiche HTTP e/o limiti di prodotto associati
Playbook e video che contengono istruzioni per diagnosticare la causa dell'errore e soluzioni efficaci da applicare per risolvere autonomamente l'errore (ove disponibili)
Correzione che puoi richiedere per risolvere autonomamente l'errore
Sono trattate le seguenti categorie di codici di errore:
Utilizza la casella Cerca di seguito per filtrare la tabella in modo da visualizzare le informazioni precedenti per un codice di errore specifico. Puoi cercare il codice di stato o qualsiasi contenuto in qualsiasi campo della 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 lo specifico proxy API.
Un criterio richiede molto tempo a causa di operazioni ad alta intensità di calcolo, carico elevato 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 è valida e supportata da Apigee,
MA
Il formato del payload inviato dal client come parte della richiesta HTTP non corrisponde al formato di codifica specificato nell'intestazione Content-Encoding
La codifica specificata nell'intestazione della risposta HTTP Content-Encoding del server di backend/destinazione è valida e supportata 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 nell'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 a seconda dell'implementazione del server di backend.
Possibile causa:
Questo errore si verifica se il server di backend risponde con il codice di stato 500 ad Apigee.
Codice di stato HTTP:
503
Messaggio di errore:
Il messaggio di errore e il formato possono variare a seconda dell'implementazione del server di backend.
Possibile causa:
Questo errore si verifica se il server di backend risponde con il codice di stato 503 ad Apigee.
Codice di stato HTTP:
504
Messaggio di errore:
Il messaggio di errore e il formato possono variare a seconda dell'implementazione del server di backend.
Possibile causa:
Questo errore si verifica se il server di backend risponde con il codice di stato 504 ad 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 codici di stato 4XX o 5XX. Puoi visualizzare questo codice di errore in API Monitoring o nel 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 entro il periodo di timeout di 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
dall'applicazione client nell'ambito delle richieste HTTP POST e PUT
inviate ad Apigee.
Nota: le richieste che non superano questo errore non possono essere acquisite nello strumento Trace, poiché il processore di messaggi esegue questa convalida in una fase molto iniziale, molto prima di elaborare la richiesta e di eseguire qualsiasi criterio nel proxy API.
Assicurati che l'applicazione client passi sempre l'intestazione
Content-Length come parte delle richieste HTTP POST e
PUT inviate ad Apigee. Ad esempio:
curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"
Anche se passi un payload vuoto con le richieste POST e PUT, assicurati che venga passata l'intestazione 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 parte del server di autorizzazione personalizzato ha causato indirizzi IP errati che causavano errori di connessione.
Errori di timeout della connessione dovuti a:
La limitazione del firewall sul server di backend impedisce ad Apigee di connettersi al 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 il controllo di integrità dei server di destinazione non vanno a buon fine.
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 il payload della richiesta dall'applicazione client per il periodo di timeout di I/O configurato sul componente del processore di messaggi.
Correggi
Assicurati che l'applicazione client invii il payload della richiesta entro il periodo di timeout di 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 dell'host del server di backend da parte del server di autorizzazione personalizzato ha causato indirizzi IP errati che causavano errori di connessione.
Errori di timeout della connessione dovuti a:
La limitazione del firewall sul server di backend impedisce ad Apigee di connettersi al server di backend.
Problemi di connettività di rete tra Apigee e il server di backend.
L'host del server di destinazione specificato nell'endpoint di destinazione non è corretto o contiene caratteri indesiderati (come lo spazio).
Questo errore può verificarsi anche se il server di backend chiude prematuramente la connessione mentre il processore di messaggi sta ancora inviando il payload della richiesta al server 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 il processore di messaggi di Apigee e il server di backend se:
L'archivio attendibilità del processore di messaggi di Apigee:
Contiene una catena di certificati che non corrisponde a quella completa del server di backend
OR
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 nome host specificato nell'endpoint di destinazione
OR
Contiene una catena di certificati errata/incompleta
Questo errore si verifica in uno dei seguenti scenari:
TargetServer non è configurato correttamente per supportare le connessioni TLS/SSL in 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
sul server 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 nessuno dei TargetEndpoint perché:
Nessuna condizione della regola di route (<RouteRule>) che corrisponda alla richiesta in un proxy
AND
Non è stata definita alcuna regola di route predefinita in ProxyEndpoint
(ad es. <RouteRule> senza alcuna condizione)
Correggi
Per risolvere questo errore:
Rivedi le regole di route definite in ProxyEndpoint e modificale per assicurarti che esista almeno una condizione della regola di route che corrisponda alla tua richiesta.
È buona norma definire una regola di route predefinita senza condizione se disponi di più RouteRules.
Assicurati che la regola di route predefinita sia sempre definita per ultima nell'elenco delle route condizionali, poiché le regole vengono valutate dall'alto verso il basso in ProxyEndpoint.
Per scoprire di più sulla definizione delle condizioni <RouteRule> in un
ProxyEndpoint, consulta le
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 di percentuale (%) o il segno di percentuale (%) seguito da caratteri esadecimali non validi non consentiti in base a
Moduli - Sezione 17.13.4.1.
Il proxy API in Apigee legge i parametri specifici del modulo contenenti caratteri non consentiti utilizzando il parametro ExtractVariables o il criterio AttributionMessage nel flusso della 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, che non può avere duplicati in Apigee, appare più di una volta con valori uguali o diversi come parte della richiesta HTTP inviata dall'applicazione client ad Apigee.
Assicurati che la richiesta HTTP inviata dall'applicazione client ad Apigee contenga sempre un nome di intestazione valido in base a quanto indicato nel documento
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 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
cambierà rispetto al nome host fornito.
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.
Assicurati che il percorso nell'URL della richiesta HTTP inviato dall'applicazione client ad Apigee non contenga caratteri non consentiti come
secondo 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 inviata dall'applicazione client nell'ambito della richiesta HTTP ad Apigee supera il limite consentito in Apigee.
La dimensione totale di tutte le intestazioni delle richieste inviate dall'applicazione client nell'ambito della richiesta HTTP ad Apigee è superiore al limite consentito in Apigee.
Questo errore si verifica se le dimensioni della riga di richiesta inviata dall'applicazione client nell'ambito della richiesta HTTP ad Apigee superano il 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 non
supportato da Apigee.
Questo errore si verifica se l'URL della richiesta del server di backend, rappresentato dalla variabile di flusso target.url, contiene un percorso che inizia con un punto interrogativo (?) invece di una barra (/), che non è non valida.
Questo errore si verifica se l'intestazione HTTP specifica, che non può avere duplicati in Apigee, appare più di una volta con valori uguali o diversi come parte della risposta HTTP inviata dal server di backend ad Apigee.
Assicurati che la risposta HTTP inviata dal server di backend ad Apigee contenga sempre un nome di intestazione valido in base a quanto indicato nel documento
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 dalla 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 della 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 nell'ambito della risposta HTTP contiene caratteri non validi, ad esempio uguale (=), virgola (,), punto e virgola (;), tab, CRLF e carattere di nuova riga.
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 da parte del server proxy a causa di firewall, ACL (elenco di controllo di accesso), problemi DNS, disponibilità della disponibilità del server di backend e così via.
Nota: il codice di stato nel messaggio di errore (faultstring) indica la causa generale 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 ha risposto con il codice di stato 306 ad Apigee.
Il codice di stato 306 è stato definito in una versione precedente della specifica HTTP. Secondo la specifica HTTP corrente, questo codice è riservato e non deve essere utilizzato.
Poiché il codice di stato 306 è riservato, assicurati che il server di backend non utilizzi 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 il 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 è 204 No Content o 205 Reset Content, ma contiene il corpo della risposta e/o una o più delle seguenti intestazioni:
Questo errore si verifica se la dimensione del payload inviata dall'applicazione client nell'ambito della richiesta HTTP ad Apigee supera il limite consentito in Apigee.
Questo errore si verifica se la dimensione totale di tutte le intestazioni di risposta inviate dal server di backend nell'ambito della risposta HTTP ad Apigee supera il limite consentito in Apigee.
Questo errore si verifica se le dimensioni della riga di risposta inviata dal server di backend nell'ambito della risposta HTTP ad Apigee superano il limite consentito in Apigee Edge.
Questo errore si verifica se l'intestazione Content-Encoding inviata dal server di backend come parte della risposta HTTP contiene il formato di codifica/payload non supportato da Apigee.
KeyAlias {KeyAlias_name} is not found in
Keystore {Keystore_Name}
Possibile causa:
Questo errore si verifica se l'alias KeyAlias specifico a cui viene fatto riferimento in TargetEndpoint o TargetServer non viene trovato nell'archivio chiavi specifico.
Correggi
Assicurati che il KeyAlias specificato in TargetEndpoint o TargetServer esista e faccia 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 in TargetEndpoint o TargetServer non contiene alcun certificato.
Correggi
Se vuoi convalidare il certificato del server di backend e utilizzare l'archivio di attendibilità in un TargetEndpoint o TargetServer, assicurati che l'archivio di attendibilità contenga i certificati validi del server di backend.