Fehlerbehebung bei persistierten GraphQL-Abfragen :headding-anchor:troubleshoot-persisted-graphql-queries

Das Aktionszentrum enthält den Warnhinweis Fehler bei persistierter GraphQL-Abfrage. Dies bedeutet, dass Sie immer dann informiert werden, wenn eine der persistierten GraphQL-Abfragen einen Fehler ausgibt.

Um Ihnen bei der Fehlerbehebung und Lösung solcher Probleme zu helfen, erläutern wir auf dieser Seite die häufigsten Ursachen von Fehlern und Schritte zu deren Behebung.

Änderungen am Inhaltsfragmentmodell :headding-anchor:changes-to-content-fragment-model

Eine persistierte GraphQL-Abfrage kann fehlschlagen, wenn sie auf veralteten GraphQL-Typen basiert. Dies ist häufig auf eine Änderung der zugrunde liegenden Inhaltsfragmentmodelle zurückzuführen.

Solche Fehler können aus verschiedenen Gründen auftreten. Beispiele sind (die Liste ist nicht vollständig), wenn die Autorin oder der Autor eines Inhaltsfragmentmodells:

  • ein Feld entfernt oder umbenennt
  • den Modelltyp aktualisiert, der die für die Fragmentreferenz zulässigen Modelle definiert
  • die Veröffentlichung eines Modells aufhebt, auf das andere Modelle verweisen

Um solche Fehler zu beheben, sollten Sie entweder:

  • die persistierte Abfrage, die die am Inhaltsfragmentmodell vorgenommenen Änderungen nicht berücksichtigt, aktualisieren
  • oder die Änderung des Modells, durch die das Problem verursacht wurde, zurücksetzen.

GraphQL-Endpunkt nicht konfiguriert :headding-anchor:graphql-endpoint-not-configured

Wenn persistierte Abfragen den Fehler-Code 404 zusammen mit der Information No suitable endpoint found zurückgeben, bedeutet dies, dass in der AEM-Umgebung kein GraphQL-Endpunkt konfiguriert ist.

Um dies zu korrigieren, führen Sie die Schritte zum Aktivieren und Veröffentlichen Ihres Endpunkts gemäß Verwalten von GraphQL-Endpunkten in AEM aus.

Fehlender Pfad in der von GraphQL persistierten Abfrage-URL :headding-anchor:missing-path-query-url

Wenn persistierte Abfragen den Fehler-Code 400 mit der Information Suffix: '/' does not contain a path zurückgeben, wird das GraphQL-Servlet ohne Pfadsuffix aufgerufen.

Das Muster sollte /graphql/execute.json/thePath sein.

Blockierung aufgrund der IP-Zulassungsliste :headding-anchor:blocked-due-to-ip-allow-list

In diesem Fall gibt die Abfrage den Fehler-Code 405 zurück.

Ein solcher Fehler ist nicht spezifisch für GraphQL. Siehe KB-Artikel 405-Fehler Nicht zulässig.

Von Dispatcher blockiert :headding-anchor:blocked-dispatcher

Wenn der GraphQL-Endpunkt beim Veröffentlichen für POST-Anfragen den Fehler 404 zurückgibt, bedeutet dies, dass die GraphQL-Abfragen auf Dispatcher-Ebene blockiert werden und der Endpunkt manuell aktiviert werden muss.

Dies sollte standardmäßig nicht der Fall sein, aber eine benutzerdefinierte Dispatcher-Konfiguration kann dieses Problem verursachen. Weitere Informationen finden Sie unter Dispatcher – Endpunktkonfiguration mit AEM Headless.

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