--- title: "Flow-Fehler debuggen" slug: "debug-a-flow-failure" updated: 2026-07-03T07:01:41Z published: 2026-07-03T07:01:41Z canonical: "support.whatfix.com/debug-a-flow-failure" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://support.whatfix.com/llms.txt > Use this file to discover all available pages before exploring further. # Flow-Fehler debuggen Wenn ein Flow nach dem Start nicht wie erwartet funktioniert, verwenden Sie Whatfix-Debug-Befehle, um zu identifizieren, warum ein bestimmter Schritt fehlgeschlagen ist. In den folgenden Szenarien müssen Sie möglicherweise einen Flow-Fehler debuggen: - [Flow läuft nicht korrekt](/studio/docs/de/flow-does-not-run-correctly) - [Flow-Tooltip flackert oder erscheint an unterschiedlicher Position](/studio/docs/de/flow-tooltip-flickers-or-appears-at-different-position) - [Flow konnte das Element für den nächsten Schritt nicht erkennen](/studio/docs/de/flow-couldnt-detect-the-element-for-the-next-step) - [Flowschritte überspringen, während Sie den Flow ausführen](/studio/docs/de/flow-steps-skip) --- ### Flow-Fehler debuggen Befolgen Sie diese Schritte, um einen Flow-Fehler zu debuggen: 1. Starten Sie den Flow, den Sie debuggen möchten. 2. Spielen Sie den Flow ab, bis er fehlschlägt. 3. Öffnen Sie die **[Entwickler-Tools](https://developer.chrome.com/docs/devtools/open)** ![debug_flow_devtools.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_devtools.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D){height="" width="500"} ausfalls_Grund 4. Gehen Sie auf den Tab **Konsole**. ![debug_console.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_console.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) 5. Geben Sie den folgenden Befehl in der Konsole ein und drücken Sie **Enter**: ``` _wfx_debug_finder('flow'); ``` ![debug_flow_finder.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_finder.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) Info Der **_wfx_debug_finder();** Befehl liefert Debug-Protokolle für alle Inhalte, die auf der Seite geladen werden. Info Der Befehl **_wfx_debug_finder();** gibt Debug-Protokolle für alle auf der Seite geladenen Inhalte zurück. Um Protokolle für einen bestimmten Inhaltstyp anzuzeigen, geben Sie den Inhaltstyp als Parameter im Befehl an. 1. Klicken Sie auf **Finder-Zusammenfassungsprotokolle**, um die Details zu erweitern. ![debug_flow_steps.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_steps.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) Die Ausgabe zeigt die Flow-ID und die Schrittnummern im folgenden Format an:\n**\:\**. 2. Klicken Sie auf die fehlgeschlagene Schrittnummer, um deren Details anzuzeigen. ![debug_flow_failed_step.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_failed_step.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) Das Schrittobjekt enthält Felder, die Ihnen helfen, die Ursache des Flow-Fehlers zu identifizieren. --- ### Bestimmen Sie, ob ein Flow-Schritt erfolgreich war oder fehlgeschlagen ist Überprüfen Sie das Feld **result**, um festzustellen, ob der Schritt erfolgreich war oder fehlgeschlagen ist. ![debug_flow_result.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_result.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) --- ### Zusammenfassung des Fehlers anzeigen Überprüfen Sie das Feld **customer_facing_reason**, um eine Zusammenfassung des Problems und eine empfohlene Lösung anzuzeigen. ![debug_flow_customer_reasons.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_customer_reasons%281%29.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) Dieses Feld enthält die folgenden Unterfelder: - **failure_reason:** Identifiziert den Grund für das Fehlschlagen des Schritts. - **possible_action**: Empfiehlt eine Aktion zur Behebung des Problems. Die folgende Tabelle listet häufige Fehlerursachen und die dafür empfohlenen Aktionen auf: | failure_reason | possible_action | | --- | --- | | Die für diesen Schritt vorgesehenen Display Rules konnten das Element nicht finden. | Überprüfen Sie die Anzeigeregel und aktualisieren Sie sie gegebenenfalls. | | Der für diesen Schritt vorgesehene CSS-Selektor konnte das Element nicht finden. | Überprüfen Sie den CSS-Selektor und aktualisieren Sie ihn gegebenenfalls. | | Schritt wird nicht auf der Seite erstellt, auf der der Flow abgespielt wurde. | Überprüfen Sie, ob vorherige Schritte vor dem fehlgeschlagenen Schritt zur korrekten Seite navigieren. | | Problem mit der Smart Detect-Konfiguration. Die in der Konfiguration definierte vertrauenswürdige HTML-Eigenschaft konnte nicht gefunden werden. | Kontaktieren Sie den Support, um Unterstützung bei der Feinabstimmung der Smart Detect-Konfiguration zu erhalten. | | Whatfix kann das ursprüngliche Element, das bei der Erstellung des Inhalts ausgewählt wurde, nicht finden. | Stellen Sie sicher, dass das Element für Benutzer sichtbar ist, und überprüfen Sie, ob die Flow-Navigation korrekt ist. | | Whatfix konnte das Element nicht finden, da sich eine oder mehrere Eigenschaften, die während der Inhaltserstellung erfasst wurden, geändert haben. | Wählen Sie das Element erneut aus, um das Problem zu beheben. | --- ### Informationen zu einem Flow-Schritt anzeigen Überprüfen Sie das Feld **step_info**. ![debug_flow_step_info.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/debug_flow_step_info.png?sv=2026-02-06&spr=https&st=2026-10-29T06%3A15%3A55Z&se=2026-10-29T07%3A15%3A55Z&sr=c&sp=r&sig=%2F3yEDJxz%2BxbDyajBaGzhEF6mX4O4NPafDqubI7LL4fY%3D) Dieses Feld enthält die folgenden Unterfelder: - **element_tag:** Der HTML-Tag des Elements, an das der Flow-Schritt angehängt ist. - **flow_titel:** Der Titel des Flows. - **is_step_optional:** Gibt an, ob der Flow-Schritt [optional](/studio/docs/de/defining-a-step-as-optional) ist oder nicht.