n8n'de Hata Yönetimi Nasıl Yapılır?
n8n hata yönetimi; Executions listesinde başarısız çalışmalar, Error Trigger ile error workflow, Stop And Error node'u, Retry on Fail ve On Error ayarları.
Miraç Kuru · Yayın 12 Ekim 2026

Bu yazıda· 9 bölüm
- 1.n8n'de workflow hata verince nerede görülür?
- 2.n8n'de error workflow nedir?
- 3.n8n'de error workflow nasıl kurulur?
- 4.Error workflow'a hangi bilgiler gelir?
- 5.Stop And Error node'u ne işe yarar?
- 6.Node ayarlarında Retry on Fail ve On Error ne işe yarar?
- 7.Error workflow hatayı nasıl bildirir?
- 8.n8n hata yönetiminde sık görülen sorunlar nasıl çözülür?
- 9.Sonraki adım
Kısa cevap
n8n'de hata yönetimi, bir workflow hata verdiğinde bunu fark etmek ve hata anında ne olacağını önceden ayarlamaktır. Başarısız execution'lar workflow'un Executions sekmesinde görülür. Error workflow, Error Trigger node'uyla başlar ve kendisine bağlanan workflow hata verdiğinde kendiliğinden çalışır. Stop And Error node'u workflow'u bilerek durdurur. Retry on Fail ve On Error ayarları ise node'un hata anındaki davranışını belirler.
- 1
Başarısız execution'ı bul
Workflow'un Executions sekmesini aç, "Filters" düğmesine tıkla ve Status alanında Failed seçeneğini seç.
- 2
Error workflow'u kur
Yeni bir workflow'a ilk node olarak Error Trigger'ı ekle, workflow'a Error Handler gibi bir ad ver ve kaydet.
- 3
Error workflow'u bağla
Hatalarını izlemek istediğin workflow'un üç nokta menüsünden Settings seçeneğini aç ve Error Workflow alanında Error Handler'ı seç.
- 4
Bildirim ekle
Error Trigger node'undan sonra bir Gmail ya da Telegram node'u ekle ve hata bilgilerini mesaja expression olarak yaz.
- 5
Node ayarlarını seç
Hata verebilecek node'ların Settings sekmesinde Retry on Fail ve On Error ayarlarını işine göre seç.
n8n'de hata yönetimi, bir workflow hata verdiğinde bunu fark etmek, nedenini bulmak ve hata anında ne olacağını önceden ayarlamaktır. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. n8n editörü, workflow'ların kurulup düzenlendiği ekrandır. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır. Temel n8n kavramları n8n nedir yazısında anlatılır.
n8n'de workflow hata verince nerede görülür?
Execution, bir workflow'un bir kez çalışmasının kaydıdır. Belgelere göre bir workflow'un bütün execution'ları, workflow'un üst menüsündeki Executions sekmesinde listelenir.
Publish, canvas'ın üst kısmında bulunan ve workflow'u canlıya alan düğmedir. Belgelere göre editörde Execute Workflow düğmesiyle başlatılan çalışma manual execution'dır. Yayımlanmış bir workflow'un kendiliğinden başlayan çalışması ise production execution'dır.
Başarısız execution'lar şu adımlarla bulunur:
- Workflow'u canvas'ta aç ve üst menüdeki Executions sekmesine tıkla. Workflow'un execution listesi açılır.
- "Filters" düğmesine tıkla. Filtre alanları açılır.
- Status alanında Failed seçeneğini seç. Listede sadece başarısız execution'lar kalır.
Başarısız bir execution şu adımlarla yeniden çalıştırılır:
- Workflow'un Executions sekmesini aç.
- Yeniden çalıştırmak istediğin execution için Refresh simgesine tıkla. İki seçenek görünür.
- Workflow'u düzelttiysen Retry with currently saved workflow, değiştirmediysen Retry with original workflow seçeneğini seç. Belgelere göre iki seçenek de önceki execution'ın verisiyle çalışır.
Örnek: Bir içerik üreticisinin workflow'u her sabah video fikirlerini bir tabloya yazar. İçerik üreticisi bir sabah tabloya kayıt eklenmediğini görür. Executions sekmesinde Status alanından Failed seçeneğini seçer ve o sabahki başarısız execution'ı açıp inceler.
n8n'de error workflow nedir?
Error workflow, başka bir workflow'un execution'ı başarısız olduğunda kendiliğinden çalışan ayrı bir workflow'dur. Error workflow'un izlediği workflow'a belgelerde ana workflow (main workflow) denir. Belgelerdeki örneğe göre error workflow, hata olduğunda e-posta ya da Slack bildirimi gönderebilir.
Error Trigger node'u, error workflow'u başlatan trigger node'dur. Belgelere göre ana workflow hata verdiğinde bu node hatanın ayrıntılarını alır ve error workflow'u çalıştırır. Her error workflow, Error Trigger node'uyla başlamak zorundadır.
Belgelere göre aynı error workflow birden çok workflow için kullanılabilir. Ücretli planlarda execution sayısı için bir sınır (kota) bulunur ve error workflow'un çalışmaları bu kotaya sayılmaz.
Örnek: Bir YouTube kanalı yöneticisi tek bir error workflow kurar. Yorum toplama, haftalık rapor ve video paylaşma workflow'larının ayarlarında bu error workflow'u seçer. Üç workflow'dan biri hata verdiğinde aynı error workflow çalışır.
n8n'de error workflow nasıl kurulur?
Error workflow şu adımlarla kurulur:
- n8n'de yeni bir workflow aç ve "Add first step" düğmesine tıkla. Trigger node'larının aranıp seçildiği node paneli (nodes panel) açılır.
- Arama kutusuna "Error Trigger" yaz ve listeden Error Trigger'ı seç. Node canvas'a eklenir.
- Workflow'a bir ad ver, örneğin "Error Handler".
- "Save" düğmesine tıkla. Workflow kaydedilir.
Error workflow, ana workflow'a şu adımlarla bağlanır:
- Hatalarını izlemek istediğin workflow'u canvas'ta aç.
- Sağ üst köşedeki üç nokta simgesine tıkla.
- Açılan menüde Settings seçeneğini seç. Tek bir workflow'un ayarlarını içeren Workflow settings penceresi açılır.
- Error Workflow (to notify when this one errors) alanında az önce kurduğun Error Handler workflow'unu seç.
- "Save" düğmesine tıkla. Bu workflow hata verdiğinde Error Handler kendiliğinden çalışır.
Belgelere göre error workflow'un yayımlanması gerekmez.
Örnek: Bir ajans çalışanı, müşteri formlarını işleyen workflow'un Workflow settings penceresinde Error Workflow alanından Error Handler'ı seçer. Form workflow'u bir gece hata verdiğinde Error Handler kendiliğinden çalışır.
Error workflow'a hangi bilgiler gelir?
JSON, verileri alan adı ve değer çiftleriyle yazan bir metin biçimidir. Belgelere göre Error Trigger node'u hatayla ilgili bilgileri JSON biçiminde alır. Varsayılan veride şu alanlar bulunur:
| Alan | Ne gösterir |
|---|---|
execution.id | Başarısız execution'ın kimliği |
execution.url | Başarısız execution'ın n8n'deki adresi |
execution.retryOf | Execution yeniden çalıştırılmışsa ilk başarısız execution'ın kimliği |
execution.error.message | Hata mesajı |
execution.error.stack | Hatanın teknik ayrıntısı (stack trace) |
execution.lastNodeExecuted | En son çalışan node'un adı |
execution.mode | Execution'ın çalışma biçimi |
workflow.id | Hata veren workflow'un kimliği |
workflow.name | Hata veren workflow'un adı |
Belgelere göre bu alanlar, aşağıdaki istisnalar dışında her zaman bulunur:
- Execution kimliği ve adresi için execution'ın veritabanına kaydedilmiş olması gerekir.
- Hata ana workflow'un trigger node'unda çıktıysa workflow çalışmadığı için kimlik ve adres gelmez.
- Yeniden çalıştırma bilgisi, sadece başarısız bir execution yeniden çalıştırıldığında gelir.
Hata ana workflow'un trigger node'unda çıkarsa error workflow'a giden veri farklıdır. Belgelere göre bu durumda execution bölümünde daha az, trigger bölümünde daha çok bilgi bulunur.
Örnek: Bir kişi, bildirim e-postasının konusuna hata veren workflow'un adını, metnine hata mesajını ve execution adresini ekler. Gelen e-postadaki adres, başarısız execution'ın n8n'deki sayfasını açar.
Stop And Error node'u ne işe yarar?
Stop And Error node'u, workflow'u istenen bir noktada durdurup hata veren node'dur. Belgelere göre bu node özel hata mesajları göstermek, belirli koşullarda execution'ı başarısız kılmak ve error workflow'a özel hata bilgisi göndermek için kullanılır. Node'un Error Type alanında iki seçenek bulunur:
| Error Type | Eklenen alan | Ne yazılır |
|---|---|---|
| Error Message | Error Message | Hata mesajı |
| Error Object | Error Object | Hatanın özelliklerini taşıyan bir JSON nesnesi |
If node'u, veriyi bir koşula göre iki yola ayıran node'dur.
Örnek: Bir içerik üreticisinin workflow'u, bir formdan gelen video fikirlerini tabloya yazar. İçerik üreticisi bir If node'uyla fikir alanının boş olup olmadığını kontrol eder. Alan boşsa veri Stop And Error node'una gider ve execution, Error Message alanındaki "Form boş geldi" mesajıyla durur. Error workflow bu mesajı içeren bir bildirim gönderir.
Node ayarlarında Retry on Fail ve On Error ne işe yarar?
Her node'un ayar penceresindeki Settings sekmesi, node'un davranışını belirleyen ayarları içerir. Belgelere göre hatayla ilgili iki ayar Retry on Fail ve On Error'dur.
Belgelere göre Retry on Fail, başarısız olan bir node'u başarılı olana kadar yeniden çalıştıran ayardır.
Örnek: Bir kişi, haftalık rapor workflow'undaki Gmail node'unun Settings sekmesinde Retry on Fail ayarını açar. Node bir çalışmada e-postayı gönderemezse n8n node'u yeniden çalıştırır.
On Error, node hata verdiğinde workflow'un ne yapacağını belirleyen ayardır. Belgelere göre seçenekler şunlardır:
| Seçenek | Ne yapar |
|---|---|
| Stop Workflow | Bütün workflow'u durdurur ve sonraki node'lar çalışmaz |
| Continue | Hataya rağmen son geçerli veriyle sonraki node'a geçer |
| Continue (using error output) | Workflow'u sürdürür ve hata bilgisini sonraki node'a aktarır |
Örnek: Bir kişi, müşteri listesindeki herkese e-posta gönderen bir workflow kurar. Gmail node'unda On Error ayarını Continue (using error output) yapar. Gönderilemeyen e-postaların hata bilgisi sonraki node'a aktarılır ve bir tabloya yazılır. Workflow diğer e-postaları göndermeye devam eder.
Error workflow hatayı nasıl bildirir?
Bildirim, error workflow'da Error Trigger node'undan sonra eklenen bir e-posta ya da mesaj node'uyla gönderilir. Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. Expression, n8n'in bir alana önceki node'lardan gelen veriyi yerleştirmek için kullandığı yazım biçimidir. Gmail node'unun credential kurulumu n8n ile Gmail otomasyonu yazısında anlatılır.
E-posta bildirimi şu adımlarla eklenir:
- Error Handler workflow'unu aç.
- Error Trigger node'unun sağındaki "Add node" (+) düğmesine tıkla. Node paneli açılır.
- Arama kutusuna "Gmail" yaz ve Gmail node'unu seç. Ardından Message (e-posta) kaynağının Send işlemini seç. Node canvas'a eklenir ve ayarları açılır.
- Credential to connect with alanında Gmail credential'ını seç.
- To alanına kendi e-posta adresini yaz. Subject alanına
workflow.name, Message alanınaexecution.error.messageveexecution.urldeğerlerini expression olarak ekle. - "Save" düğmesine tıkla. Error Handler, bir sonraki hatada e-posta gönderir.
Bildirimi e-posta yerine Telegram'dan almak için Gmail node'u yerine Telegram node'u eklenir. Telegram'da mesaj gönderen otomatik hesabın (bot) kurulumu n8n ile Telegram botu yazısında anlatılır.
Örnek: Bir YouTube kanalı yöneticisi Error Handler workflow'una Telegram node'unu ekler. Mesaja hata veren workflow'un adını, hata mesajını ve execution adresini ekler. Gece çalışan bir workflow hata verdiğinde yönetici sabah Telegram'da mesajı görür ve mesajdaki adresten başarısız execution'ı açar.
Error workflow kuruluysa Executions listesini her gün açmak gerekmez. Bildirim geldiğinde Executions listesini açmak yeterlidir.
n8n hata yönetiminde sık görülen sorunlar nasıl çözülür?
Kurulumda karşılaşılabilecek durumlar ve çözümleri şunlardır:
- Error workflow hiç çalışmıyorsa ana workflow'un Workflow settings penceresinde Error Workflow alanını kontrol et. Ana workflow'un yayımlanmış ve kendiliğinden çalışıyor olmasına da bak.
- Bildirimde execution adresi boş geliyorsa önce hatanın ana workflow'un trigger node'unda çıkıp çıkmadığına bak. Trigger node hatalarında ayrıntılar, error workflow'a gelen verinin
triggerbölümünde bulunur. - Hata sonraki bir node'da çıktığı hâlde execution adresi boş geliyorsa ana workflow'un Workflow settings penceresinde Save failed production executions ayarını kontrol et. Bu ayar, yayımlanmış workflow'ların başarısız execution'larının kaydedilip kaydedilmeyeceğini belirler.
Örnek: Bir kişi, Error Handler'ı denemek için ana workflow'u editörde elle çalıştırır ve bildirim gelmez. Ana workflow'u Publish düğmesiyle yayımlar. Bir sonraki otomatik çalışmada hata olduğunda bildirim gelir.
Sonraki adım
Error Handler workflow'unu kur ve Error Trigger node'undan sonra bir Gmail ya da Telegram node'u ekle. Ardından hata bildirimi almak istediğin workflow'u aç. Workflow settings penceresinde Error Workflow alanından Error Handler'ı seç ve "Save" düğmesine tıkla.
Kurduğun bu error workflow, otomasyonlarını kendi hâline bırakabileceğin kalıcı bir sisteme dönüştürmenin ilk adımıdır.
Sık sorulanlar
Ana workflow elle çalıştırılınca error workflow neden çalışmıyor?
Belgelere göre Error Trigger node'u sadece otomatik çalışan bir workflow hata verdiğinde çalışır. Error workflow, yayımlanmış ve kendiliğinden çalışan bir ana workflow'a bağlanarak denenir.
Bir error workflow birden çok workflow için kullanılabilir mi?
Kullanılabilir. Belgelere göre aynı error workflow, birden çok workflow'un Workflow settings penceresindeki Error Workflow alanında seçilebilir.
Error workflow'a gelen veride execution adresi neden yok?
Belgelere göre execution kimliği ve adresi için execution'ın veritabanına kaydedilmesi gerekir. Hata ana workflow'un trigger node'unda çıktıysa workflow çalışmadığı için bu bilgiler gelmez.
Stop And Error node'u ne zaman kullanılır?
Stop And Error node'u, workflow'u belirlenen bir koşulda bilerek durdurmak için kullanılır. Belgelere göre node, Error Message ya da Error Object seçeneğiyle error workflow'a özel hata bilgisi gönderir.
On Error ayarında Continue ile Continue (using error output) arasında ne fark var?
Belgelere göre Continue, hataya rağmen son geçerli veriyle sonraki node'a geçer. Continue (using error output) ise hata bilgisini sonraki node'a aktarır.
Kaynaklar
- 1.n8n Docs, Handle errors gracefullyErişim: 12 Ekim 2026
- 2.n8n Docs, Error Trigger nodeErişim: 12 Ekim 2026
- 3.n8n Docs, Stop And Error nodeErişim: 12 Ekim 2026
- 4.n8n Docs, Configure workflow settingsErişim: 12 Ekim 2026
- 5.n8n Docs, Work with nodesErişim: 12 Ekim 2026
- 6.n8n Docs, Understand executionsErişim: 12 Ekim 2026
- 7.n8n Docs, View executions for a single workflowErişim: 12 Ekim 2026
İlgili yazılar

n8n Nedir, Ne İşe Yarar?
n8n'in ne olduğu, nasıl çalıştığı, nasıl kullanıldığı, ücretlendirmesi, örnek workflow'lar ve n8n ile Make arasındaki farklar.
4 dk okuma

n8n ile Gmail Otomasyonu Nasıl Yapılır?
n8n'de Gmail node'uyla e-posta gönderme, okuma ve etiketleme; Gmail Trigger ile gelen e-postalarla workflow başlatma ve sık görülen hatalar.
6 dk okuma

n8n ile Telegram Botu Nasıl Yapılır?
n8n ile Telegram botu kurmak: BotFather ile bot açma, Telegram Trigger, dil modeliyle cevap, Simple Memory ile hafıza ve sık görülen webhook sorunları.
4 dk okuma

n8n Schedule Trigger Nasıl Kullanılır?
n8n Schedule Trigger ile workflow'u belirli aralıklarla ya da saatlerde çalıştırma; Trigger Rules, cron ifadesi, saat dilimi ve sık görülen sorunlar.
7 dk okuma

n8n Webhook Nedir, Nasıl Kullanılır?
n8n Webhook node'unun ne olduğu, test ve canlı adres farkı, kurulum adımları, cevap seçenekleri, kimlik doğrulama ve sık görülen sınırlar.
4 dk okuma

