Résolution des problèmes liés aux requêtes GraphQL persistantes troubleshoot-persisted-graphql-queries
Le Centre d’actions inclut l’alerte Erreur de requête persistante de GraphQL. Cela signifie que vous êtes informé chaque fois que l’une de vos requêtes persistantes GraphQL renvoie une erreur.
Pour vous aider à résoudre ces problèmes, cette page couvre les causes les plus courantes des échecs et les étapes permettant de les résoudre.
Modifications apportées au modèle de fragment de contenu changes-to-content-fragment-model
Une requête persistante GraphQL peut échouer lorsqu’elle est basée sur des types GraphQL obsolètes, souvent en raison d’une modification des modèles de fragment de contenu sous-jacents.
De telles erreurs peuvent se produire pour diverses raisons. Voici quelques exemples (la liste n’est pas exhaustive) lorsque l’auteur d’un modèle de fragment de contenu :
- supprime ou renomme un champ
- met à jour le Type de modèle qui définit les modèles autorisés pour la référence au fragment
- annule la publication d’un modèle référencé par d’autres modèles
Pour corriger ces erreurs, vous devez effectuer l’une des opérations suivantes :
- mettez à jour la requête persistante qui ne parvient pas à s’adapter aux modifications apportées au modèle de fragment de contenu
- annuler la modification sur le modèle qui a introduit le problème
Point d’entrée GraphQL non configuré graphql-endpoint-not-configured
Lorsque les requêtes persistantes renvoient le code d’erreur 404, ainsi que la No suitable endpoint found d’informations, cela signifie qu’aucun point d’entrée GraphQL n’est configuré dans l’environnement AEM.
Pour corriger ce problème, suivez les étapes d’activation et de publication de votre point d’entrée à partir de Gérer les points d’entrée GraphQL dans AEM.
Chemin manquant dans l’URL de la requête persistante GraphQL missing-path-query-url
Si les requêtes persistantes renvoient le code d’erreur 400 avec la Suffix: '/' does not contain a path d’informations, le servlet GraphQL est appelé sans suffixe de chemin.
Le modèle doit être /graphql/execute.json/thePath.
Bloqué en raison d’une liste autorisée IP blocked-due-to-ip-allow-list
Dans ce cas, la requête renvoie le code d’erreur 405.
Une telle erreur n’est pas spécifique à GraphQL. Voir l’article de la base de connaissances Erreur 405 non autorisée.
Bloqué par le Dispatcher blocked-dispatcher
Si le point d’entrée GraphQL renvoie l’erreur 404 lors de la publication pour les requêtes POST, cela signifie que les requêtes GraphQL sont bloquées au niveau du Dispatcher et que le point d’entrée doit être activé manuellement.
Cela ne doit pas être le cas par défaut, mais une configuration Dispatcher personnalisée peut entraîner ce problème. En savoir plus sous Dispatcher - Configuration des points d’entrée avec AEM Headless.