Häufige Fehler bei der Migration und wie Sie sie beheben
· Von AI Compare
Die zehn Fehler, auf die Teams nach dem Wechsel zu n8n stoßen, und wie Sie jeden davon genau beheben.
Die häufigsten Fehler nach der Migration zu n8n
1. „Workflow could not be activated“ oder der Webhook empfängt keine Daten
Ursache: Die Quell-App zeigt noch auf die Test-Webhook-URL, oder der Workflow ist nicht aktiv.
Lösung: n8n-Webhooks haben eine Test URL (funktioniert nur, solange Sie auf „Listen for test event“ klicken) und eine Production URL (funktioniert nur bei aktivem Workflow). Aktivieren Sie den Workflow und fügen Sie die Production URL in der Quell-App ein. Bei selbst gehostetem n8n setzen Sie WEBHOOK_URL, damit n8n Ihre öffentliche Domain statt localhost anzeigt.
2. Zeitpläne laufen zur falschen Zeit
Ursache: Die Zeitzone ist nicht gesetzt.
Lösung: Setzen Sie GENERIC_TIMEZONE (selbst gehostet) oder die Zeitzone des Workflows in den Workflow settings.
3. Nodes laufen zu oft (oder zu selten)
Ursache: ein Missverständnis bei Items. n8n führt jeden Node einmal pro eingehendem Item aus. Ein migrierter „Looping“-Schritt oder ein zusätzlich eingebauter Make-Iterator führt zu doppelter Verarbeitung.
Lösung: Entfernen Sie unnötige Schleifen. Nutzen Sie Aggregate, um Items zusammenzufassen, wenn Sie eine einzige Ausgabe brauchen (zum Beispiel eine Slack-Nachricht, die 20 Zeilen zusammenfasst), oder aktivieren Sie Execute Once an einem Node.
4. „Cannot read properties of undefined“ in Expressions
Ursache: Das referenzierte Feld fehlt bei einigen Items, oder Sie haben den falschen Node referenziert.
Lösung: Nutzen Sie Optional Chaining und Standardwerte: {{ $json.customer?.email ?? '' }}. Referenzieren Sie frühere Nodes explizit: {{ $('Stripe Trigger').item.json.data.object.id }}.
5. OAuth-Fehler: „invalid_grant“, „redirect_uri_mismatch“, ablaufende Tokens
Ursachen und Lösungen:
- redirect_uri_mismatch: Die Redirect-URL in der Entwicklerkonsole der App muss exakt mit der im n8n-Credential angezeigten übereinstimmen (https, Domain, Pfad).
- invalid_grant nach 7 Tagen (Google): Ihre Google-OAuth-App ist im Modus „Testing“. Veröffentlichen Sie sie oder nutzen Sie eine Internal-App in Google Workspace.
- Fehlende Scopes: Ergänzen Sie die benötigten Scopes und verbinden Sie das Credential neu.
Siehe Leitfaden zu Credentials.
6. Doppelte Datensätze nach der Umstellung
Ursache: Der alte Zap oder das alte Szenario und der neue Workflow liefen gleichzeitig, oder ein Webhook wurde erneut zugestellt.
Lösung: Schalten Sie die alte Automatisierung in dem Moment ab, in dem Sie die neue aktivieren. Nutzen Sie Upserts (anlegen oder aktualisieren) und speichern Sie externe IDs, damit Workflows idempotent sind.
7. Datumsformate weichen von Zapier ab
Ursache: Der Formatter von Zapier lieferte ein bestimmtes Format; n8n gibt ISO-Datumswerte zurück.
Lösung: Formatieren Sie explizit: {{ $json.date.toDateTime().toFormat('dd/MM/yyyy') }}.
8. Binärdateien fehlen (Anhänge, PDFs)
Ursache: Dateidaten liegen in der binary-Eigenschaft des Items, nicht im JSON, und ein Node dazwischen hat sie verworfen.
Lösung: Prüfen Sie den Namen der Binär-Eigenschaft (zum Beispiel attachment_0 oder data) und tragen Sie ihn im empfangenden Node ein. Bei manchen Nodes (etwa Edit Fields) muss „Include binary data“ aktiviert sein.
9. Rate-Limit-Fehler (429)
Ursache: n8n verarbeitet Items schnell und stößt an API-Limits, die das langsamere Polling von Zapier vermieden hat.
Lösung: Aktivieren Sie Retry On Fail mit Wartezeit zwischen den Versuchen, nutzen Sie Loop Over Items mit Batch-Größe und einen Wait-Node oder die Batching-Optionen des Nodes.
10. Der selbst gehosteten Instanz geht der Speicher aus
Ursache: große Dateien, große JSON-Payloads oder viele gleichzeitige Ausführungen auf einem kleinen Server.
Lösung: Mehr RAM, Daten in Batches verarbeiten, große Binärdaten nicht im Arbeitsspeicher halten (Binary Mode „filesystem“ nutzen) oder in den Queue Mode mit Workern wechseln.
Debugging-Gewohnheiten, die Stunden sparen
- Pinnen Sie beim Bauen die Trigger-Daten, damit Sie ohne neue Ereignisse erneut ausführen können.
- Öffnen Sie fehlgeschlagene Ausführungen und prüfen Sie Eingabe und Ausgabe des ersten roten Nodes.
- Ergänzen Sie einen Error Trigger-Workflow, der Fehler mit Workflow-Name und Link in Slack postet.
