疑難排解持續的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 path400錯誤碼,則呼叫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的端點設定下檢視更多資訊。

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