n8n Artikel 07 von 08

Fehler sauber abfangen

Logs lesen, Ursachen finden und Benachrichtigungen einbauen, bevor ein Workflow still versagt.

Hier liest du n8n Logs, findest fehlerhafte Nodes und baust stabilere Fehlerbehandlung in Workflows ein. Irgendwann läuft ein Workflow nicht so wie geplant. Das ist normal. Kein Grund zur Panik. Nach Datenverarbeitung ist Fehlerbehandlung der Schritt vom Bastel-Workflow zum zuverlässigen Alltagssystem. n8n gibt dir gute Werkzeuge um Fehler zu finden und zu behandeln.

Die häufigsten Fehlerquellen

Fehlende oder falsche Daten

Ein erwartetes Feld kommt leer an oder hat einen anderen Namen als erwartet. Der häufigste Fehler überhaupt.

Verbindungsprobleme

Ein externer Dienst antwortet nicht oder gibt einen Fehler zurück. Meistens vorübergehend, manchmal ein Hinweis auf ein abgelaufenes Token.

Zeitüberschreitung

Eine Anfrage dauert zu lange. Passiert bei langsamen APIs oder wenn zu viele Daten auf einmal verarbeitet werden.

Logikfehler

Der Workflow läuft durch, macht aber nicht das was du erwartet hast. Oft ein falsches Feld angesprochen oder eine Bedingung falsch formuliert.

So gehst du Fehler an

Ausführungsprotokoll öffnen

n8n speichert jede Workflow-Ausführung. Du siehst genau bei welcher Node der Fehler aufgetreten ist und welche Daten dort ankamen.

Die fehlerhafte Node isolieren

Klick auf die rot markierte Node. Du siehst die Eingangsdaten, die Ausgangsdaten und die genaue Fehlermeldung.

Im Test-Modus nachstellen

Du kannst eine fehlerhafte Ausführung erneut laden und ab der problematischen Node neu starten. So sparst du dir das komplette Durchlaufen des Workflows.

Fehlerbehandlung einbauen

Wenn du weißt dass bestimmte Fehler auftreten können, kannst du darauf reagieren. Ein Error-Trigger schickt dir zum Beispiel eine Benachrichtigung sobald ein Workflow fehlschlägt.

Proaktive Fehlerbehandlung

Fehler reaktiv zu beheben ist gut. Noch besser ist es, Workflows so zu bauen dass sie mit Fehlern umgehen können. n8n bietet dafür den "Error Trigger"-Workflow. Das ist ein eigener Workflow der automatisch startet wenn ein anderer fehlschlägt.

Ich habe einen solchen Workflow der mir per Telegram eine Nachricht schickt sobald etwas schief läuft. Mit dem Workflow-Namen, dem Fehlertyp und einem Link zur Ausführung. Ich muss nicht regelmäßig nachschauen ob alles läuft. Wenn es ein Problem gibt, werde ich informiert.

Meine Empfehlung

Richte den Error-Trigger frühzeitig ein, auch wenn deine Workflows noch einfach sind. Je mehr Automatisierungen du hast, desto wichtiger wird es zu wissen wenn etwas still versagt. Ein Workflow der fehlschlägt ohne dass du es merkst ist schlimmer als einer der laut Fehler macht.

Was du jetzt kannst

Du weißt wie du Fehler findest, verstehst und proaktiv darauf reagierst. Im letzten Artikel gehen wir zum Abschluss einen Schritt weiter: Wir verbinden die bisherigen Bausteine zu einem einfachen KI-Agenten in n8n.

Der nächste sinnvolle Schritt

Wenn du diesen Teil verstanden hast, passen diese Seiten als Nächstes:

Häufige Fragen

Wo suche ich zuerst bei n8n Fehlern?

Prüfe den fehlgeschlagenen Node, seine Eingabedaten, die Fehlermeldung und danach externe Dienste oder Zugangsdaten.

Was bringt ein Error Trigger?

Er kann bei Fehlern automatisch Benachrichtigungen, Logs oder Ersatzabläufe starten.

Warum laufen Tests, aber Produktion nicht?

Produktivdaten, Berechtigungen, Rate Limits und Zeitpunkte unterscheiden sich oft von Testläufen.

Zurück: Daten verstehen Weiter: Einfachen KI-Agenten bauen