Résolution des problèmes liés aux requêtes GraphQL persistantes troubleshoot-persisted-graphql-queries

La variable Centre d’actions inclut la variable Erreur de requête persistante de GraphQL alerte 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, nous vous expliquons la méthode le plus courant causes des échecs et étapes à suivre pour les corriger.

Modifications apportées au modèle de fragment de contenu changes-to-content-fragment-model

Une requête GraphQL persistante peut échouer lorsqu’elle est basée sur des types GraphQL obsolètes, souvent en raison d’un changement dans les modèles de fragment de contenu sous-jacents.

Cela peut se produire pour diverses raisons. Par exemple, lorsqu’un auteur de modèle de contenu :

  • supprime ou renomme un champ
  • met à jour les modèles autorisés définis pour une référence à un fragment ;
  • annule la publication d’un modèle référencé par d’autres modèles.
  • autres actions et raisons

Pour résoudre ce problème, procédez de l’une des manières suivantes :

  • la requête persistante qui échoue doit être mise à jour pour prendre en compte la modification dans le modèle de fragment de contenu.
  • ou la modification du modèle qui a introduit le problème doit être rétablie.

Point de terminaison GraphQL non configuré graphql-endpoint-not-configured

Lorsque les requêtes conservées renvoient la variable 400 ou 500 code d’erreur, ainsi que les informations No suitable endpoint found, cela signifie qu’aucun point de terminaison GraphQL n’est configuré dans l’environnement AEM.

Pour corriger ce problème, procédez comme suit pour activer et publier votre point de terminaison à partir de Gestion des points de fin GraphQL dans AEM.

Chemin d’accès manquant dans l’URL de requête persistante de GraphQL missing-path-query-url

Si les requêtes conservées renvoient la variable 400 ou 500 code d’erreur avec les informations Suffix: '/' does not contain a path, le servlet GraphQL est appelé sans suffixe de chemin.

Le modèle doit être /graphql/execute.json/thePath.

Blocage en raison de la liste autorisée IP blocked-due-to-ip-allow-list

Dans ce cas, la requête renvoie la variable 405 code d’erreur.

Ce n’est pas spécifique à GraphQL. Voir l’article de la base de connaissances Erreur 405 non autorisée.

Blocage par Dispatcher blocked-dispatcher

Si le point de terminaison GraphQL renvoie la variable 404 erreur lors de la publication pour POST , cela signifie que les requêtes GraphQL sont bloquées au niveau du dispatcher et que le point de terminaison 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. Voir plus sous Dispatcher : configuration du point d’entrée avec AEM sans affichage.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab