疑難排解持續的GraphQL查詢 troubleshoot-persisted-graphql-queries

動作中心包含​ GraphQL持續查詢錯誤 ​警示。 這表示只要您的其中一個GraphQL持續查詢擲回錯誤，就會通知您。

為了協助您疑難排解及解決這類問題，本頁會涵蓋​ 最常見的 ​失敗原因，以及如何修正這些問題的步驟。

內容片段模式的變更 changes-to-content-fragment-model

GraphQL持續查詢如果以過時的GraphQL型別為基礎，則可能會失敗，通常是因為基礎內容片段模式發生變更。

發生這類錯誤的原因有很多。 範例包括（此清單並非詳盡無遺），當內容片段模型的作者時：

若要解決這類錯誤，您應該：

未設定GraphQL端點 graphql-endpoint-not-configured

當持續性查詢傳回404錯誤碼以及資訊No suitable endpoint found時，表示在AEM環境中未設定任何GraphQL端點。

若要修正此問題，請依照啟用和發佈端點的步驟，從在AEM中管理GraphQL端點。

GraphQL持續查詢URL中缺少路徑 missing-path-query-url

如果持續性查詢傳回包含資訊Suffix: '/' does not contain a path的400錯誤碼，則呼叫GraphQL servlet時不會包含路徑尾碼。

模式應為/graphql/execute.json/thePath。

由於IP允許清單而遭到封鎖 blocked-due-to-ip-allow-list

在這種情況下，查詢會傳回405錯誤碼。

這類錯誤並非GraphQL特有的錯誤。 請參閱知識庫文章不允許錯誤。

已被Dispatcher封鎖 blocked-dispatcher

如果GraphQL端點在POST請求的發佈上傳回404錯誤，這表示GraphQL查詢在Dispatcher層級遭到封鎖，且端點需要手動啟用。

根據預設，不應該是這種情況，但自訂Dispatcher設定可能會導致此問題。 在Dispatcher — 使用AEM Headless的端點設定下檢視更多資訊。