持久的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。 请参阅知识库文章405不允许错误。

被Dispatcher阻止 blocked-dispatcher

如果GraphQL端点在发布POST请求时返回404错误，这意味着在Dispatcher级别阻止GraphQL查询，并且需要手动启用端点。

默认情况下不应出现这种情况，但自定义Dispatcher配置可能会导致此问题。 在Dispatcher — 使用AEM Headless的端点配置下查看更多。