Fehlerbehebung bei persistierten GraphQL-Abfragen 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 die häufigsten Ursachen von Fehlern und die Schritte zu deren Behebung.

Änderungen am Inhaltsfragmentmodell 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.

Dies kann aus verschiedenen Gründen geschehen. Zum Beispiel, wenn ein Inhaltsmodellautor oder eine -autorin:

  • ein Feld entfernt oder umbenennt
  • die für einen Fragmentverweis definierten zulässigen Modelle aktualisiert
  • die Veröffentlichung eines Modells aufhebt, auf das andere Modelle verweisen
  • sonstige Aktionen und Gründe

Gehen Sie zur Fehlerbehebung wie folgt vor:

  • Die persistierte Abfrage, die fehlschlägt, sollte aktualisiert werden, um die Änderung am Inhaltsfragmentmodell zu berücksichtigen,
  • oder die Änderung des Modells, durch die das Problem verursacht wurde, sollte zurückgesetzt werden

GraphQL-Endpunkt nicht konfiguriert graphql-endpoint-not-configured

Wenn persistierte Abfragen den Fehler-Code 400 oder 500 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 missing-path-query-url

Wenn persistierte Abfragen den Fehler-Code 400 oder 500 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 blocked-due-to-ip-allow-list

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

Dies gilt nicht spezifisch für GraphQL. Siehe KB-Artikel 405-Fehler Nicht zulässig.

Von Dispatcher blockiert 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