Fehlerbehebung bei Flow-Fehlern und Nutzungsgrenzen

In diesem Dokument werden häufige Fehler und Einschränkungen beschrieben und es wird darauf eingegangen, warum diese Fehler und Einschränkungen auftreten und wie du sie beheben kannst. Es gibt zwei Arten von Fehlern, die bei Flow auftreten können: dauerhafte Fehler und vorübergehende Fehler.

Vorübergehende Fehler

Vorübergehende Fehler sind kurzzeitige Fehler, die auftreten, wenn Flow eine Aufgabe nicht abschließen kann. Die fehlerhaften Aufgaben werden solange wiederholt, bis sie entweder erfolgreich ausgeführt werden oder bis ein Zeitüberschreitungslimit erreicht wird. Wenn Flow beispielsweise beim Ausführen einer Connector-Aktion keinen Partner kontaktieren kann, wiederholt Flow diese Aktion mehrmals, bevor der Vorgang gestoppt wird.

Wiederholungsversuche werden gestaffelt, wobei die Verzögerung zwischen den einzelnen Versuchen gegenüber der vorherigen Verzögerung zunimmt. Wenn bei einem Workflow vorübergehende Fehler auftreten, verbleibt der Workflow in der Regel solange im Zustand Wird durchgeführt, solange Wiederholungsversuche ausgeführt werden.

Wenn eine Aufgabe nach einem Wiederholungsversuch erfolgreich ausgeführt wird, wird der Workflow fortgesetzt. Wenn die Wiederholungsversuche zu einem permanenten Fehler führen, schlägt der Workflow fehl. Jeder Workflow-Abschnitt verfügt über ein kombiniertes oberes Ausführungslimit von 36 Stunden. Wenn ein Schritt mit vorübergehenden Fehlern nicht ausgeführt werden kann, bevor dieses Limit erreicht wird, schlägt der Workflow fehl.

Workflows mit Warteschritten werden in Abschnitte unterteilt, was sich darauf auswirkt, wie Zeitüberschreitungslimits in einem Workflow berechnet werden. Jeder Abschnitt umfasst eine Gruppe von Aufgaben, die zusammen ausgeführt werden. Dabei hat jeder Abschnitt ein Zeitüberschreitungslimit von 36 Stunden. Wenn ein Workflow beispielsweise einen Warteschritt hat, der eine Stunde Wartezeit beinhaltet, werden die Aufgaben vor dem Warteschritt zusammen in einem Abschnitt und die Aufgaben hinter dem Warteschritt zusammen in einem anderen Abschnitt ausgeführt. Wenn ein Workflow mehrere Warteschritte umfasst, werden die Aufgaben zwischen den Warteschritten zusammen in einem Abschnitt ausgeführt. Workflows ohne Warteschritt werden als einzelner Abschnitt gehandhabt.

Gelegentliche vorübergehende Fehler treten häufig auf. Wenn du jedoch einen Workflow hast, bei dem über mehrere Durchläufe hinweg immer wieder derselbe vorübergehende Fehler auftritt, musst du den Workflow möglicherweise neu konfigurieren.

Zeit für Schritt abgelaufen

Step timed out – Diese Fehler treten normalerweise auf, wenn eine Aufgabe im Workflow versucht, innerhalb eines Abschnitts zu viele Daten abzufragen. Dieser Fehler tritt häufig in Workflows auf, die durch Listen iterieren, insbesondere wenn es sich um verschachtelte Listen handelt, die zu groß sind, um zeitnah abgerufen zu werden.

Wenn dieser Fehler bei einem Workflow auftritt, wird der Trigger oder Warteschritt als retrying angezeigt.

Um dieses Problem zu beheben, überprüfe alle Bedingungen, die auf Listen und verschachtelte Listen zugreifen, um sicherzustellen, dass die Bedingungen korrekt sind. Ein häufiges Problem ist, dass eine Bedingung alle Produkte in einem Shop überprüft und nicht nur die Produkte in einer Bestellung.

5xx-Status

Die meisten Flow-Aktionen umfassen HTTP-Aufrufe. Gelegentlich können Netzwerk- oder andere Serverprobleme dazu führen, dass HTTP-Aufrufe fehlschlagen und einen Fehlercode zwischen 500 und 599 zurückgeben. Wenn dieser Fehler vereinzelt auftritt, handelt es sich nicht um ein Problem. Ein wiederholtes Auftreten deutet jedoch möglicherweise auf ein Problem mit dem Server hin, der die Aufgabe ausführt. Es liegt wahrscheinlich nicht daran, wie der Schritt konfiguriert ist.

Dieser Fehlertyp tritt häufig in der Aktion HTTP-Anfrage senden auf. Er kann jedoch auch bei anderen Aufgaben auftreten.

GraphQL gedrosselt

Das Gesamtarbeitsvolumen eines Workflows wird durch API-Quotengrenzen eingeschränkt, die teilweise durch deinen Plan bestimmt werden. In der Regel werden diese Grenzen nicht erreicht, es sei denn, es handelt sich um einen sehr komplexen Workflow oder der Workflow enthält einen unabsichtlichen Designfehler. Im Folgenden findest du Beispiele für Szenarien, die zu diesem Fehler führen können:

• Liquid-Code oder Bedingungen in der Workflow-Schleife für eine Liste mit großen Datenmengen wie z. B. die Überprüfung von Metafeld-Werten, die HTML enthalten.
• Liquid-Code oder Bedingungen in der Workflow-Schleife für eine große Liste wie z. B. die Ausführung einer Schleife für shop.orders in einem großen Shop.
• Ein Workflow führt zu einer unendlichen Schleife, in der der Workflow weiterhin neue Workflow-Durchläufe erstellt. Dies kann beispielsweise vorkommen, wenn der Workflow den Trigger Kunden-Tags hinzugefügt verwendet und die Aktion Kunden-Tags hinzufügen enthält.

Wenn die Grenze erreicht ist, wird der Fehler GraphQL throttled angezeigt. Dieser Fehler kann sich auf andere Workflows auswirken, wenn sie einen Durchlauf starten. Dieser Fehler sollte also umgehend nach dem Auftreten behoben werden.

Dauerhafte Fehler

Dauerhafte Fehler sind Fehler, die auftreten, wenn Flow eine Aufgabe nicht abschließen und die Aufgabe nicht wiederholt werden kann. Wenn Flow beispielsweise keine E-Mail senden kann, weil die E-Mail-Adresse ungültig ist, wird die Aufgabe nicht wiederholt. Stattdessen schlägt der Workflow fehl.

Flow hat keine Berechtigung für dein Google-Tabellen-Konto. Verbinde dein Konto erneut.

Der Google Tabellen-Connector erfordert, dass du dein Google-Konto mit Flow verknüpfst, damit du Schreibberechtigungen für die Tabelle erhältst. Dieser Fehler kann auftreten, wenn Flow keine Schreibberechtigung für eine Tabelle hat, entweder weil das Konto nicht mehr mit Flow verknüpft ist oder weil dieses Konto nicht auf die Tabelle zugreifen kann.

Um dieses Problem zu beheben, musst du sicherstellen, dass das Konto, das für den Connector verwendet wird, das Blatt öffnen kann und Zugriff auf die Bearbeitung hat. Wenn das falsche Konto verknüpft ist, kannst du es trennen und ein neues Konto verbinden.

Schritte:

1. Öffne oder erstelle einen neuen Workflow.
2. Füge eine Aktion hinzu.
3. Wähle den Google Tabellen-Connector aus.
4. Klicke auf Verbindung trennen und anschließend auf Verbinden.

Flow-Aktion mit ungültigen Eigenschaften empfangen. Der Kunde akzeptiert kein Marketing.

Die Aktion Marketing-E-Mail senden versendet keine E-Mails an Kunden, die nicht zugestimmt haben, diese E-Mails zu erhalten, und schlägt dauerhaft fehl, wenn der Workflow diesen Vorgang trotzdem ausführt.

Um dieses Problem zu beheben, füge eine Bedingung im Workflow hinzu, die den Abonnementstatus der Kunden überprüft. Du kannst sicherstellen, dass Kunden zugestimmt haben, Marketing-E-Mails zu erhalten, bevor du sie verschickst. Folge den Schritten unter Verwaltung von E-Mail-Abonnentenlisten.

Fehlende Ressource für [Ressourcentyp]

Dieser Fehler weist darauf hin, dass eine Ressource, z. B. customer oder order, gelöscht wurde, bevor der Workflow die Daten abrufen konnte. Dies geschieht meistens nach einem Warteschritt, ist jedoch auch nach dem Auslösen eines Triggers möglich, wenn die Ressource nach dem Trigger-Ereignis sehr schnell gelöscht wird.

Beim Auftreten eines Fehlers eine Benachrichtigung erhalten

Wenn sich Fehler auf deinen Shop-Betrieb auswirken, kannst du Benachrichtigungen einrichten, wenn ein Fehler auftritt. Fehlerbenachrichtigungen können wie alle anderen Workflows erstellt werden, indem der Trigger Workflow-Fehler aufgetreten verwendet wird. Fehlerbenachrichtigungen sind so konzipiert, dass sie Störungen begrenzen, sodass du nur eine Benachrichtigung pro Workflow-Version erhältst.

Für den Anfang kannst du eine der folgenden Vorlagen verwenden:

• Shopify-Benachrichtigung erhalten, wenn Fehler beim Ausführen eines Workflows erkannt werden
• Benachrichtigung per E-Mail erhalten, wenn Fehler beim Ausführen eines Workflows erkannt werden
• Slack-Benachrichtigung erhalten, wenn Fehler beim Ausführen eines Workflows erkannt werden

Ausführungen erneut starten

In einigen Fällen kann bei einer Workflow-Ausführung ein Fehler auftreten oder die Ausführung wird nicht wie vorgesehen vorgenommen. Nach der Fehlerbehebung und dem Beheben von Problemen im entsprechenden Workflow können vorherige Ausführungen manuell erneut gestartet werden, um das Ergebnis vorheriger Ausführungen rückwirkend zu beheben. Erfahre mehr über das Wiederholen von Workflow-Ausführungen.