对 Flow 错误和使用限制进行故障排除

此文档介绍了常见错误和限制、发生原因以及解决方法。在 Flow 中,您可能遇到两种类型的错误:永久性错误和暂时性错误。

暂时性错误

暂时性错误是 Flow 无法完成任务时发生的临时错误。系统会重试这些错误,直到成功或达到超时限制为止。例如,如果 Flow 在执行连接器操作时无法联系合作伙伴,则 Flow 会多次重试此任务,直到放弃为止。

重试会逐渐展开,每次后续尝试的延迟时间都会比前一次延迟的时间更长。通常,当工作流遇到暂时性错误时,在重试任务时,它仍会长时间处于运行状态。

成功重试任务后,工作流将继续。如果重试的任务遇到永久性错误,则工作流将失败。每个工作流部分的累计执行时间上限为 36 小时。如果某个具有暂时性错误的步骤在达到该限制之前未成功,则工作流将失败。

具有等待步骤的工作流将被分为多个部分,这会影响工作流中超时限制的计算方式。每个部分都包含一组一起执行的任务,而每个部分都有各自的 36 小时时间限制。例如,如果工作流等待步骤的等待时间为一个小时,则等待步骤之前的任务将在一个部分中一起执行,而等待步骤之后的任务将在另一个部分中一起执行。如果工作流有多个等待步骤,则每个等待步骤之间的任务将在一个部分中一起执行。没有等待步骤的工作流将被视为一个部分。

偶尔出现暂时性错误是常见情况。但是,如果您的工作流在多次运行中始终遇到相同的暂时性错误,则可能需要重新配置工作流。

步骤超时

Step timed out 当工作流中的某个任务尝试在一个部分中查询过多数据时,通常会出现错误。此错误经常发生在迭代较大列表(特别是嵌套列表)而无法及时获取数据的工作流中。

当工作流遇到此错误时,触发器或等待步骤将显示为 retrying

若要解决此问题,请检查访问列表和嵌套列表的任何条件,以确保其正确无误。一个常见问题是条件会检查商店中的所有产品,而不是仅检查某一订单中的产品。

5xx 状态

大多数 Flow 操作都涉及 HTTP 调用。有时,网络或其他服务器问题可能会导致 HTTP 调用失败,并返回 500 到 599 之间的错误代码。出现一次此类错误不是问题,但重复出现可能表示处理任务的服务器存在问题,而不是步骤的配置方式存在问题。

发送 HTTP 请求操作中最常出现此类错误,但大多数任务中都可能出现此错误。

GraphQL 被限制

工作流完成的工作总量受 API 频率限制的限制,您的套餐是此限制的部分决定因素。通常,除非工作流很复杂或存在意外设计错误,否则不会达到这些限制。下方是可能导致此错误的情况示例:

  • 工作流中的 Liquid 或条件遍历包含大量数据的列表,例如检查包含 HTML 的元字段值。
  • 工作流中的 Liquid 或条件遍历大型列表,例如遍历大型商店中的 shop.orders
  • 工作流导致无限循环,其中工作流会一直创建新的工作流运行。例如,如果工作流使用已添加客户标签触发器并包含添加客户标签操作,则可能发生这种情况。

如果达到了限制,您将收到 GraphQL throttled 错误。此错误可能会影响其他尝试运行的工作流,因此发生此错误时应立即进行解决。

永久性错误

永久性错误是 Flow 无法完成任务并且无法重试任务时发生的错误。例如,如果 Flow 因邮箱无效而无法发送电子邮件,则它不会重试任务。工作流将失败。

Flow 不具有访问您 Google 表格账户的权限。请重新连接您的账户。

Google 表格连接器要求您将 Google 账户链接到 Flow,然后才能获得写入表格的权限。当 Flow 无权写入表格时,可能会出现此错误,原因可能是账户已与 Flow 断开链接,或者该账户无法访问该表格。

若要解决此问题,请确保用于连接器的账户可以打开表格并拥有编辑访问权限。如果链接了错误的账户,您可以断开账户连接并连接新账户。

步骤:

  1. 打开或创建新工作流。
  2. 添加操作。
  3. 选择 Google 表格连接器。
  4. 点击断开连接,然后点击连接

收到的 Flow 操作具有无效属性。客户不接受营销。

发送营销电子邮件操作不会向未同意接收电子邮件的客户发送电子邮件,如果工作流尝试这样做,则操作将永久性失败。

若要解决此问题,请添加工作流中添加检查客户订阅状态的条件。在发送营销电子邮件之前,您可以确保客户已同意接收这些电子邮件。按照电子邮件订阅者列表管理中的步骤操作。

缺少 [资源类型] 的资源

此错误表示资源(例如 customerorder)在工作流提取其数据之前已被删除。大多数情况下,此错误在等待步骤之后发生,但如果资源在触发器事件发生后非常快速地被删除,则触发器上也可能发生此错误。

在出现错误时接收通知

如果出现错误会影响您的商店运营,您可以设置要在发生错误时发送的通知。与任何其他工作流相似,可以使用出现工作流错误触发器创建错误通知。错误通知旨在限制干扰,使每个工作流版本只有一次相应通知

您可以使用以下一个模板来开始设置通知:

重试运行

在某些情况下,工作流运行可能会遇到错误或未按预期运行。对相关工作流中的问题进行故障排除和修复后,可以手动重试过往运行,以便对过往运行的结果进行追溯性修复。详细了解重试工作流运行

准备好开始使用 Shopify 进行销售了吗?

免费试用