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.