与 GraphQL API 交互
与 GraphQL API 交互问题排查

问题排查

通过 Internal GraphQL ServerAutomation 执行 GraphQL Query 时,如果输出结果与预期不符,可以通过查看日志来找出问题所在。

当 Query 失败时接收通知

默认情况下,每当日志中添加 🔴 错误条目时,插件菜单中就会显示通知徽章

通知徽章
通知徽章

这将告知我们某个 GraphQL Query 的执行失败,并提示我们查看日志。

定位问题

查看日志。如果发现 🔴 错误,那里肯定就是问题所在。

如果发现 🟡 警告,说明 Query 遇到了意外情况,这可能是问题的根源。

例如,如果某个自动化任务未能执行,日志中将包含一条记录其状态和数据的条目。

在此截图中,一条包含 🔴 错误的日志条目帮助我们了解到,自动化中传递给 Query 的变量无效:

查看单条日志
查看单条日志

日志条目内容如下:

🔴 Error [Automation Rule "Create metadata on publish lesson"][Persisted Query "Create SEO metadata for MasterStudy LMS" ← title] Execution with errors: Non-nullable variable 'courseOrLessonId' has not been provided

由此可知,问题在于自动化中定义的变量名称有误(自动化中定义的是 lessonOrCourseId,但在持久化 Query 中使用的名称是 courseOrLessonId)。