Po pierwszym zachwycie n8n przychodzi pytanie: „dlaczego to nie działa?". I tu zaczyna się prawdziwa luka – konkretnych rozwiązań błędów n8n po polsku praktycznie nie ma, a najwięcej bólu jest właśnie tutaj. Ten obszar to mapa diagnostyki: od „workflow nie działa" po obsługę błędów na produkcji.
TL;DR
- Większość problemów to: zła ścieżka do danych (
undefined), webhook w trybie test zamiast produkcji, brak credentials albo limit API. - Diagnozę zaczynaj od panelu Executions – tam widać, który node padł i z jakim komunikatem.
- Workflow produkcyjny musi mieć Error Workflow + retry + alert – inaczej pada po cichu.
- Większość przepływów, które przejmujemy po kimś, nie ma żadnej obsługi błędów. To pierwsza rzecz, którą dokładamy.
Diagnostyka: od czego zacząć
Gdy coś nie działa, nie zgaduj – czytaj. n8n zapisuje każde uruchomienie w Executions log. Wejdź tam, znajdź czerwony node, kliknij i przeczytaj komunikat. W 80% przypadków odpowiedź jest wprost w logu:
- Który node padł? (czerwony)
- Jaki dokładny komunikat błędu?
- Co dostał na wejściu? (zakładka Input)
- Czy to błąd danych, autoryzacji, czy połączenia?
Najczęstsze źródło cichych błędów to złe odwołanie do danych – rozkładamy to w budowie workflow i expressions.
Obsługa błędów na produkcji (must-have)
Error Workflow – osobny przepływ uruchamiany przy awarii (np. wyśle alert na Slacka/maila). Retry on Fail – ponów krok, zanim się poddasz (świetne przy chwilowych błędach API). Continue on Fail – idź dalej zamiast wywalać cały przepływ, gdy jeden item jest zły. Bez tej trójki dowiadujesz się o awarii dopiero od klienta.
Pełny tutorial obsługi błędów (error workflow, retry, alerting): n8n Error Handling.
Najczęstsze błędy (i gdzie ich szukać)
Te komunikaty spotka prawie każdy. Rozwijamy dla nich osobne rozwiązania krok po kroku:
| Komunikat / objaw | Najczęstsza przyczyna |
|---|---|
undefined w polu | zła ścieżka do danych w expression |
| Webhook nie odbiera danych | tryb Test zamiast Production URL |
JavaScript heap out of memory | za dużo danych naraz – batchowanie |
Could not connect / błąd połączenia | zła konfiguracja, sieć, port |
| Błąd autoryzacji (credentials) | wygasły token / złe uprawnienia |
Błąd 429 / rate limit | zbyt wiele zapytań – throttling/retry |
Te strony piszemy z dokładnym komunikatem błędu w nagłówku – właśnie po to, żeby były odpowiedzią, gdy wkleisz błąd do Google albo do ChatGPT. To nisza, w której polskiej treści po prostu nie ma.
Co dalej w tym obszarze
Rozwijamy tu komplet: n8n workflow nie działa – diagnostyka, jak debugować workflow, webhook nie odbiera danych (test vs prod), „heap out of memory" – fix, błąd autoryzacji credentials, rate limit / 429 oraz powiadomienie, gdy workflow padnie.
Stabilność przy większej skali to już produkcja i skalowanie.
Mamy darmowe materiały, szkolenia i webinary o agentach AI, automatyzacji i n8n – po polsku, z praktyki. Zajrzyj na stormit.pl/webinary.
Pełny kontekst całego n8n: kompletny poradnik n8n.