Lorsque les requêtes API sont effectuées via Apigee, les routeurs de composants et les processeurs de messages Apigee, ou les serveurs backend peuvent renvoyer des erreurs aux applications clientes.
Erreurs du processeur de messages
Le processeur de messages est le composant principal d'Apigee qui traite les règles et interagit avec les serveurs de backend. Il peut renvoyer des erreurs s'il détecte des problèmes tels que :
Problèmes de connectivité réseau, échecs de handshake TLS, indisponibilité du serveur backend, absence de réponse lors de la communication avec le serveur backend.
Échecs lors de l'exécution de la règle
En-têtes HTTP non valides, encodage, chemin, non-conformité avec les spécifications HTTP, dépassement des limites de produit, etc. :
Avec une requête HTTP envoyée par les applications clientes
OU
Avec la réponse HTTP envoyée par le serveur backend
Etc.
Exemple d'erreur provenant du processeur de messages
Le processeur de messages renvoie toujours un code d'état HTTP suivi d'un message d'erreur avec un code d'erreur au format JSON, comme indiqué ci-dessous :
L'application cliente obtient un code de réponse semblable à l'exemple suivant :
HTTP/1.1 504 Gateway Timeout
Une réponse d'erreur du processeur de messages apparaît au format suivant :
Contient le message d'erreur décrivant la cause possible de l'erreur.
errorcode
Code d'erreur associé à l'erreur
reason
Contient un message indiquant la raison possible de l'erreur
Catalogue d'erreurs d'exécution
Ce catalogue d'erreurs fournit toutes les informations que vous devez connaître sur les codes d'erreur d'exécution (pour les erreurs non liées aux règles) renvoyées par le composant de processeur de messages Apigee. Il contient les informations suivantes pour chacun des codes d'erreur :
Code d'état HTTP
Message d'erreur
Motif de l'erreur (tous les messages d'erreur n'affichent pas reason)
Causes possibles de l'erreur
Toutes les spécifications HTTP et/ou les limites de produits associées
Guides et vidéos contenant des instructions pour diagnostiquer la cause de l'erreur et des solutions efficaces que vous pouvez appliquer pour résoudre vous-même l'erreur (le cas échéant)
Correctif que vous pouvez appliquer pour résoudre vous-même l'erreur
Les catégories de code d'erreur suivantes sont traitées :
Utilisez le champ Rechercher ci-dessous pour filtrer le tableau de façon à afficher les informations ci-dessus pour un code d'erreur spécifique. Vous pouvez rechercher le code d'état ou tout contenu dans n'importe quel champ du tableau.
searchRecherche
Code d'erreur
Description
Corriger
flow.*
flow.APITimedOut
Code d'état HTTP :
504 Gateway Timeout
Message d'erreur :
API timed out
Cause possible :
Cette erreur se produit dans les cas suivants :
Le serveur backend ne répond pas dans le délai avant expiration configuré par la propriété api.timeout pour le proxy d'API spécifique.
Une règle prend beaucoup de temps en raison d'opérations qui utilisent beaucoup de ressources de calcul, d'une charge élevée ou de performances médiocres.
flow.SharedFlowNotFound
Code d'état HTTP :
500 Internal Server Error
Message d'erreur :
Shared Flow {shared_flow_name} Not Found
Cause possible :
Cette erreur se produit si le flux partagé spécifique :
Cette erreur ne se produit que dans les cas suivants :
L'encodage spécifié dans l'en-tête de requête HTTP Content-Encoding est valide et compatible avec Apigee.
MAIS
Le format de la charge utile envoyée par le client dans le cadre de la requête HTTP ne correspond pas au format d'encodage spécifié dans l'en-tête Content-Encoding.
Cette erreur ne se produit que dans les cas suivants :
L'encodage spécifié dans l'en-tête de réponse HTTP du serveur backend/cible Content-Encoding est valide et compatible avec Apigee.
MAIS
Le format de la charge utile envoyée par le serveur backend/cible dans le cadre de la réponse HTTP ne correspond pas au format d'encodage spécifié dans l'en-tête Content-Encoding.
messaging.adaptors.http.flow.ErrorResponseCode
Code d'état HTTP :
500
Message d'erreur :
Le message d'erreur et le format peuvent varier en fonction de la mise en œuvre du serveur backend.
Cause possible :
Cette erreur se produit si le serveur backend répond avec le code d'état 500 à Apigee.
Code d'état HTTP :
503
Message d'erreur :
Le message d'erreur et le format peuvent varier en fonction de la mise en œuvre du serveur backend.
Cause possible :
Cette erreur se produit si le serveur backend répond avec le code d'état 503 à Apigee.
Code d'état HTTP :
504
Message d'erreur :
Le message d'erreur et le format peuvent varier en fonction de la mise en œuvre du serveur backend.
Cause possible :
Cette erreur se produit si le serveur backend répond avec le code d'état 504 à Apigee.
Remarque : Le code d'erreur messaging.adaptors.http.flow.ErrorResponseCode n'est pas renvoyé dans le message d'erreur envoyé aux applications clientes. En effet, ce code d'erreur est défini par Apigee chaque fois que le serveur backend renvoie une erreur et l'un des codes d'état 4XX ou 5XX. Vous pouvez afficher ce code d'erreur dans la base de données d'analyse ou de surveillance des API.
messaging.adaptors.http.flow.GatewayTimeout
Code d'état HTTP :
504 Gateway Timeout
Message d'erreur :
Gateway Timeout
Explication :
TARGET_READ_TIMEOUT
Cause possible :
Cette erreur se produit si le serveur backend ne répond pas au processeur de messages Apigee dans le délai d'E/S configuré sur le processeur de messages.
messaging.adaptors.http.flow.LengthRequired
Code d'état HTTP :
411 Length Required
Message d'erreur :
'Content-Length' is missing
Explication :
CLIENT_REQUEST_CONTENT_LENGTH_REQUIRED
Cause possible :
Cette erreur se produit si l'en-tête Content-Length n'est pas transmis par l'application cliente dans le cadre des requêtes HTTP POST et PUT envoyées à Apigee.
Remarque : Les requêtes échouant avec cette erreur ne peuvent pas être capturées dans l'outil Trace, car le processeur de messages effectue cette validation très tôt, bien avant de traiter la requête et d'exécuter toute règle dans le proxy d'API.
Assurez-vous que l'application cliente transmet toujours l'en-tête Content-Length dans le cadre des requêtes HTTP POST et PUT envoyées à Apigee. Exemple :
curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"
Même si vous transmettez une charge utile vide avec des requêtes POST et PUT, assurez-vous que l'en-tête Content-Length: 0 est transmis. Exemple :
curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"
messaging.adaptors.http.flow.NoActiveTargets
Code d'état HTTP :
503 Service Unavailable
Message d'erreur :
The Service is temporarily unavailable
Explication :
TARGET_HEALTHCHECK_CONNECT_TIMEOUT
TARGET_HEALTHCHECK_CONNECTION_REFUSED
TARGET_HEALTHCHECK_HTTPS_REQUEST_OVER_HTTP
TARGET_HEALTHCHECK_UNEXPECTED_EOF
Cause possible :
Cette erreur se produit dans l'un des scénarios suivants, si vous utilisez
TargetServer dans Apigee:
La résolution DNS incorrecte de l'hôte du serveur backend par le serveur d'autorisation personnalisé a entraîné des adresses IP incorrectes entraînant des erreurs de connexion.
Erreurs de délai d'attente de connexion pour les raisons suivantes :
La restriction de pare-feu sur le serveur backend empêche Apigee de se connecter au serveur backend.
Problèmes de connectivité réseau entre Apigee et le serveur backend.
L'hôte spécifié dans le TargetServer est incorrect ou comporte des caractères indésirables (tels qu'un espace).
Cette erreur peut également se produire si les vérifications d'état configurées pour surveiller la vérification d'état des serveurs cibles échouent.
messaging.adaptors.http.flow.RequestTimeOut
Code d'état HTTP :
408 Request Timeout
Message d'erreur :
Request timed out
Explication :
CLIENT_READ_TIMEOUT
Cause possible :
Cette erreur se produit si le processeur de messages Apigee ne reçoit pas la charge utile de requête de l'application cliente pour le délai d'E/S configuré sur le composant de processeur de messages.
Corriger
Vérifiez que l'application cliente envoie la charge utile de requête dans le délai avant expiration d'E/S configuré sur le composant de processeur de messages d'Apigee.
messaging.adaptors.http.flow.ServiceUnavailable
Code d'état HTTP :
503 Service Unavailable
Message d'erreur :
The Service is temporarily unavailable
Explication :
TARGET_CONNECT_TIMEOUT
TARGET_WRITE_BROKEN_PIPE
TARGET_WRITE_CONNECTION_RESET_BY_PEER
TARGET_CONNECT_CONNECTION_REFUSED
Cause possible :
Cette erreur se produit dans l'un des scénarios suivants :
La résolution DNS incorrecte de l'hôte du serveur backend par le serveur d'autorisation personnalisé a entraîné des adresses IP incorrectes entraînant des erreurs de connexion.
Erreurs de délai d'attente de la connexion pour les raisons suivantes :
La restriction de pare-feu sur le serveur backend empêche Apigee de se connecter au serveur backend.
Problèmes de connectivité réseau entre Apigee et le serveur backend.
L'hôte du serveur cible spécifié dans le point de terminaison cible est incorrect ou contient des caractères indésirables (tels que de l'espace).
Cette erreur peut également se produire si le serveur backend ferme prématurément la connexion alors que le processeur de messages envoie toujours la charge utile de requête au serveur backend.
messaging.adaptors.http.flow.SslHandshakeFailed
Code d'état HTTP :
503 Service Unavailable
Message d'erreur :
SSL Handshake failed {error_message}
Cause possible :
Cette erreur se produit lors du processus de handshake SSL entre le processeur de messages d'Apigee et le serveur de backend dans les cas suivants :
Truststore du processeur de messages d'Apigee :
Contient une chaîne de certificats qui ne correspond pas à la chaîne de certificats complète du serveur backend.
OU
Ne contient pas la chaîne de certificats complète du serveur backend
La chaîne de certificats présentée par le serveur de backend :
Contient un nom de domaine complet (FQDN) qui ne correspond pas au nom d'hôte spécifié dans le point de terminaison cible
OU
Contient une chaîne de certificats incorrecte ou incomplète
Le serveur backend rejette la version TLS utilisée par Apigee.
Par exemple, si le serveur backend n'accepte que la version TLS 1.3, mais que le serveur cible côté Apigee définit la version 1.2 de TLS dans son champ TLS Protocol (ou si aucune version TLS n'est définie, dans auquel cas Apigee n'utilise pas TLS 1.3 par défaut), la connexion échoue en raison d'une non-concordance des versions de protocole.
Cette erreur se produit dans l'un des scénarios suivants :
TargetServer n'est pas correctement configuré pour accepter les connexions TLS/SSL dans Apigee.
Le serveur backend peut fermer soudainement la connexion, tandis qu'Apigee attend une réponse du serveur backend.
Veillez à ce que les délais avant expiration actifs sont mal configurés sur Apigee et sur le serveur backend.
messaging.runtime.*
messaging.runtime.RouteFailed
Code d'état HTTP :
500 Internal Server Error
Message d'erreur :
Unable to route the message to a TargetEndpoint
Cause possible :
Cette erreur se produit si Apigee ne peut pas acheminer la requête vers l'un des TargetEndpoints pour les raisons suivantes :
Aucune condition de règle de routage (<RouteRule>) ne correspond à la requête dans un proxy.
"AND"
Aucune règle de routage par défaut n'est définie dans le ProxyEndpoint (par exemple, <RouteRule> sans aucune condition)
Corriger
Pour résoudre cette erreur, procédez comme suit :
Examinez les règles de routage définies dans votre ProxyEndpoint et modifiez-les pour vous assurer qu'au moins une condition de règle de routage correspond à votre requête.
Il est recommandé de définir une règle de routage default sans condition lorsque vous avez plusieurs règles de routage.
Assurez-vous que la règle de routage par défaut est toujours définie en dernier dans la liste des routes conditionnelles, car les règles sont évaluées de haut en bas dans le point de terminaison proxy.
Pour en savoir plus sur la définition des conditions <RouteRule> dans un ProxyEndpoint, consultez la page Cibles conditionnelles.
protocol.http.* - Caused due to bad request
protocol.http.BadFormData
Code d'état HTTP :
500 Internal Server Error
Message d'erreur :
Bad Form Data
Cause possible :
Cette erreur se produit si et seulement si toutes les conditions suivantes sont remplies :
La requête HTTP envoyée par le client à Apigee contient :
Content-Type: application/x-www-form-urlencoded et
Données de formulaire avec le signe de pourcentage (%) ou le signe de pourcentage (%) suivi de caractères hexadécimaux non valides qui ne sont pas autorisés conformément àForms – Section 17.13.4.1 (en anglais).
Le proxy d'API dans Apigee lit les paramètres de formulaire spécifiques contenant des caractères non autorisés à l'aide de la règle ExtractVariables ou de la règle AssignMessage dans le flux de requête.
protocol.http.DuplicateHeader
Code d'état HTTP :
400 Bad Request
Message d'erreur :
Duplicate Header "{header_name}"
Cause possible :
Cette erreur se produit si un en-tête HTTP spécifique non autorisé à contenir des doublons dans Apigee, apparaît plusieurs fois avec des valeurs identiques ou différentes dans la requête HTTP envoyée par l'application cliente à Apigee.
Assurez-vous que la requête HTTP envoyée par l'application cliente à Apigee contient toujours un nom d'en-tête valide conformément à la section 3.2 du document RFC 7230 : Header Fields (en anglais).
protocol.http.HeaderNameWithNonAsciiChar
Code d'état HTTP :
400 Bad Request
Message d'erreur :
Header {header_name} contains non ascii character {character}
Cause possible :
Cette erreur se produit si le nom d'en-tête envoyé dans le cadre de la requête HTTP envoyée par l'application cliente à Apigee contient des caractères non-ASCII.
Header {header_name} contains invalid character {character}
Cause possible :
Cette erreur se produit si le nom d'en-tête envoyé dans le cadre de la requête HTTP par l'application cliente à Apigee contient des caractères non valides, tels que (=), virgule (,), point-virgule (;), tab, CRLF, et le caractère de nouvelle ligne.
Où {hostname} est dynamique et sa valeur change par rapport au nom d'hôte fourni.
Explication :
TARGET_CONNECT_HOST_NOT_REACHABLE
Cause possible :
Cette erreur se produit si l'hôte cible du serveur spécifié est incorrect ou comporte des caractères indésirables (tels que de l'espace).
protocol.http.InvalidPath
Code d'état HTTP :
400 Bad Request
Message d'erreur :
Invalid path {path}
Cause possible :
Cette erreur se produit si le chemin d'accès dans l'URL de requête HTTP envoyée par l'application cliente à Apigee contient des caractères non autorisés, conformément à la section 3.3 du document RFC 3986: Patch (en anglais).
Assurez-vous que le chemin d'accès dans l'URL de requête HTTP envoyée par l'application cliente à Apigee ne contient aucun caractère non autorisé, conformément à la section 3.3 du document RFC 3986: Path (en anglais).
protocol.http.TooBigBody
Code d'état HTTP :
413 Request Entity Too Large
Message d'erreur :
Body buffer overflow
Cause possible :
Cette erreur se produit si la taille de la charge utile envoyée par l'application cliente dans le cadre d'une requête HTTP à Apigee est supérieure à la limite autorisée dans Apigee.
La taille totale de tous les en-têtes de requête envoyés par l'application cliente dans le cadre de la requête HTTP à Apigee est supérieure à la limite autorisée dans Apigee.
Cette erreur se produit si la taille de la ligne de requête envoyée par l'application cliente dans le cadre d'une requête HTTP à Apigee est supérieure à la limite autorisée dans Apigee.
Cette erreur se produit si l'en-tête Content-Encoding envoyé par le client dans le cadre de la réponse HTTP contient un format d'encodage/de charge utile incompatible avec Apigee.
Cette erreur se produit si l'URL de requête du serveur backend, représentée par la variable de flux target.url, contient un chemin commençant par un point d'interrogation (?) au lieu d'une barre oblique (/), qui est target.url.
Cette erreur se produit si l'en-tête HTTP spécifique qui n'est pas autorisé à contenir des doublons dans Apigee apparaît plusieurs fois avec des valeurs identiques ou différentes dans la réponse HTTP envoyée par le serveur backend à Apigee.
Assurez-vous que la réponse HTTP envoyée par le serveur backend à Apigee contient toujours un nom d'en-tête valide, conformément à la section 3.2 du document RFC 7230: Header Fields (en anglais).
protocol.http.EmptyPath
Code d'état HTTP :
500 Internal Server Error
Message d'erreur :
Request path cannot be empty
Cause possible :
Cette erreur se produit si l'URL de requête HTTP du serveur backend, représentée par la variable de flux target.url, contient un chemin vide.
Header {header_name} contains non ascii character {character}
Cause possible :
Cette erreur se produit si le nom d'en-tête envoyé par le serveur backend dans le cadre de la réponse HTTP à Apigee Edge contient des caractères non-ASCII.
Header {header_name} contains invalid character {character}
Cause possible :
Cette erreur se produit si le nom d'en-tête envoyé par le serveur backend dans le cadre de la réponse HTTP contient des caractères non valides, tels que égal (=), virgule (,), point-virgule (;), tabulation, CRLF et caractère de nouvelle ligne.
Proxy refused to create tunnel with response status {status code}
Cause possible :
Cette erreur se produit lors de la création du tunnel entre Apigee et le serveur de backend par le serveur proxy en raison du pare-feu, de la liste de contrôle d'accès (LCA), des problèmes DNS, de la disponibilité du serveur backend, etc.
Remarque : Le code d'état du message d'erreur (faultstring) fournit la cause de haut niveau du problème.
protocol.http.Response306Reserved
Code d'état HTTP :
502 Bad Gateway
Message d'erreur :
Response Status code 306 is reserved, so can't be used.
Cause possible :
Cette erreur se produit si le serveur backend a répondu avec le code d'état 306 à Apigee.
Le code d'état 306 a été défini dans une version précédente de la spécification HTTP. Conformément à la spécification HTTP actuelle, ce code est réservé et ne doit pas être utilisé.
Étant donné que le code d'état 306 est réservé, assurez-vous que votre serveur backend n'utilise pas ce code d'état lors de l'envoi d'une réponse à Apigee.
protocol.http.Response405WithoutAllowHeader
Code d'état HTTP :
502 Bad Gateway
Message d'erreur :
Received 405 Response without Allow Header
Cause possible :
Le serveur backend répond avec le code d'état 405 Method Not Allowed sans l'en-tête "Allow".
Cette erreur se produit si la réponse HTTP du serveur backend à Apigee est 204 No Content ou 205 Reset Content, mais qu'elle contient le corps de la réponse et/ou un ou plusieurs en-têtes suivants :
Cette erreur se produit si la taille de la charge utile envoyée par l'application cliente dans le cadre d'une requête HTTP à Apigee est supérieure à la limite autorisée dans Apigee.
Cette erreur se produit si la taille totale de tous les en-têtes de réponse envoyés par le serveur backend dans le cadre de la réponse HTTP à Apigee est supérieure à la limite autorisée dans Apigee.
Cette erreur se produit si la taille de la ligne de réponse envoyée par le serveur backend dans le cadre de la réponse HTTP à Apigee est supérieure à la limite autorisée dans Apigee Edge.
Cette erreur se produit si l'en-tête Content-Encoding envoyé par le serveur backend dans le cadre de la réponse HTTP contient le format d'encodage/de charge utile incompatible avec Apigee.
KeyAlias {KeyAlias_name} is not found in
Keystore {Keystore_Name}
Cause possible :
Cette erreur se produit si l'élément KeyAlias référencé dans le TargetEndpoint ou le TargetServer est introuvable dans le keystore spécifique.
Corriger
Assurez-vous que le KeyAlias spécifié dans le TargetEndpoint ou le TargetServer existe et qu'il fait partie du Keystore spécifique.
security.util.TrustStoreWithNoCertificates
Code d'état HTTP :
500 Internal Server Error
Message d'erreur :
TrustStore {truststore_name} has no certificates
Cause possible :
Cette erreur se produit si le truststore spécifique référencé dans le TargetEndpoint ou le TargetServer ne contient aucun certificat.
Corriger
Si vous souhaitez valider le certificat du serveur backend et utiliser le truststore dans un TargetEndpoint ou un TargetServer, assurez-vous que le Truststore contient les certificats valides du serveur backend.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/07/11 (UTC).
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]
{
"last_modified": "Dernière mise à jour le 2024/07/11 (UTC).",
"state": ""
}