n8n'de Yeni Başlayanların Yaptığı 7 Kritik Hata

n8n öğrenmeye başladığınızda bazı n8n hataları kaçınılmaz görünebilir. Ancak bu hataları önceden bilmek, saatlerce debug yapmaktan ve production'da beklenmedik sorunlarla karşılaşmaktan sizi kurtarır.

n8n nedir sorusunun cevabını biliyorsunuz ve ilk workflow'larınızı kurmaya başladınız. Harika! Ama bu aşamada neredeyse herkesin düştüğü tuzaklar var.

Bu yazıda, n8n'de yeni başlayanların en sık yaptığı 7 kritik hatayı ve bunlardan nasıl kaçınacağınızı detaylı şekilde inceliyoruz.

İçindekiler

• Hata 1: Her Şeyi Tek Workflow'a Sığdırmak
• Hata 2: Error Handling Eklememek
• Hata 3: Hardcoded Değerler Kullanmak
• Hata 4: Webhook'ları Güvenliksiz Bırakmak
• Hata 5: JSON Veri Tiplerini Anlamamak
• Hata 6: Test Etmeden Production'a Almak
• Hata 7: Workflow'ları İsimlendirmemek
• Bonus: Best Practice Takvimi
• Sıkça Sorulan Sorular

Hata 1: Her Şeyi Tek Workflow'a Sığdırmaya Çalışmak

En yaygın hatalardan biri, tüm otomasyonu tek bir devasa workflow'a sıkıştırmaya çalışmaktır. Bu sorunu n8n topluluğunda defalarca görüyoruz.

Problem

• 50+ node'lu workflow'lar debug etmek imkansız hale gelir
• Bir hata tüm süreci durdurur
• Bakım ve güncelleme kabusa döner
• Performans sorunları ortaya çıkar
• Ekip çalışmasında çakışmalar yaşanır

Çözüm

Modüler yaklaşım benimseyin:

1. Sub-workflow'lar kullanın: Büyük süreçleri mantıksal parçalara bölün. n8n'in Execute Sub-workflow node'u tam olarak bunun için tasarlandı.
2. "Wait for Completion" seçeneği: Sub-workflow'un tamamlanmasını bekleyip beklememeyi kontrol edebilirsiniz. Asenkron işlemler için bu seçeneği kapatmak performansı artırır.
3. Sub-workflow conversion: n8n 1.97+ sürümlerinde, mevcut node'ları seçip sağ tık menüsünden otomatik olarak sub-workflow'a dönüştürebilirsiniz. Expression referansları otomatik güncellenir.
4. Tek sorumluluk prensibi: Her workflow tek bir iş yapsın.

Örnek Yapı:

Ana Workflow → Lead İşleme Sub-workflow
            → Email Gönderme Sub-workflow
            → CRM Güncelleme Sub-workflow

İdeal Workflow Boyutu

• 10-20 node arası ideal
• Maksimum 30 node
• Bunun üzerinde mutlaka bölün

13 n8n projesi yazımızda her biri modüler yapıda tasarlanmış proje örnekleri bulabilirsiniz.

Hata 2: Error Handling Eklememek

Yeni başlayanların çoğu, workflow'lar production'da çökmeden error handling eklemiyor. n8n'in resmi dokümantasyonunda bile bu konuya ayrı bir bölüm ayrılmıştır.

Problem

• Hatalar sessizce oluşur, haberiniz olmaz
• Müşteri verileri kaybolabilir
• Debugging zorlaşır
• Güvenilirlik düşer

Çözüm

Her workflow'a mutlaka error handling ekleyin:

1. Error Trigger Node: Hata olduğunda ayrı bir workflow başlatır. Aynı error workflow'u birden fazla workflow için kullanabilirsiniz.
2. Error Branch: Her kritik node'a hata dalı ekleyin. Node ayarlarında "On Error" seçeneğini "Continue with Error Output" olarak ayarlayın.
3. Retry Logic: Geçici hatalar (API timeout, rate limit) için yeniden deneme mekanizması ekleyin.
4. Stop and Error Node: Kendi belirlediğiniz koşullarda workflow'u kasıtlı olarak durdurup error workflow'u tetikleyebilirsiniz.

Retry Ayarları İçin Başlangıç Değerleri:

• Deneme sayısı: 3-5
• Denemeler arası bekleme: 5-10 saniye
• API rate limit'lerine göre ayarlayın

Bildirim Sistemi:

Hata → Error Trigger → Slack/Email Bildirimi → Log Kaydetme

Kritik Kural

Her workflow için Error Workflow ayarlayın: Settings → Error Workflow seçin.

Not: Error Trigger node sadece otomatik çalışan workflow'larda tetiklenir. Manuel test sırasında çalışmaz, bu yüzden aktif etmeden önce production'da test etmeyi unutmayın.

Hata 3: Hardcoded Değerler Kullanmak

URL'leri, API key'lerini ve ID'leri direkt node'lara yazmak, başlangıçta kolay görünse de büyük bir hatadır.

Problem

• Ortam değişikliğinde (dev → prod) her şeyi manuel değiştirmeniz gerekir
• API key'leri workflow JSON'unda görünür (güvenlik riski!)
• Güncelleme yapmak zorlaşır
• Workflow paylaşımı tehlikeli hale gelir

Çözüm

Environment Variable kullanın:

1. n8n ayarlarında environment variable tanımlayın
2. Expression'larda $env.VARIABLE_NAME kullanın
3. Credential'ları n8n'in credential yönetiminde saklayın

Doğru Yaklaşım:

// Yanlış
"https://api.example.com/v1/users"

// Doğru
{{ $env.API_BASE_URL }}/users

Credential Kullanımı:

• HTTP Request node'larında predefined credential type seçin
• n8n, API key enjeksiyonunu güvenli şekilde yapar
• Asla API key'i manuel olarak header'a yazmayın
• n8n 2.0 ile credential yönetimi daha da güçlendi; dynamic credential update'ler destekleniyor

n8n self-hosting rehberimizde environment variable yapılandırmasını Docker ile nasıl yöneteceğinizi detaylı anlattık.

Hata 4: Webhook'ları Güvenliksiz Bırakmak

Public webhook URL'lerini herhangi bir güvenlik olmadan bırakmak ciddi risk oluşturur. n8n'in webhook kimlik doğrulama dokümantasyonu bu konuda net uyarılar içerir.

Problem

• Herkes webhook'unuzu tetikleyebilir
• DDoS saldırılarına açık olursunuz
• Kötü niyetli veri gönderilmesi
• Data breach riski

Çözüm

Kimlik doğrulama katmanları ekleyin:

1. Header Auth: Webhook ayarlarında Header Auth etkinleştirin
   • Secret key tanımlayın
   • Gelen isteklerin doğru header'ı içerdiğini kontrol edin
   • Yanlış istekler otomatik 401 ile reddedilir
2. Basic Auth: Kullanıcı adı ve şifre ile basit kimlik doğrulama
3. JWT Auth: JSON Web Token ile gelişmiş doğrulama (n8n'in desteklediği üçüncü yöntem)
4. HMAC Signature Verification: Stripe, GitHub, Shopify gibi servisler için
   • İmza doğrulama ekleyin
   • Hassas finansal veriler için kritik
5. IP Whitelist: Belirli IP'lerden gelen istekleri kabul edin

En Az Yapılması Gereken:

• Header Auth etkinleştirme (%90 güvenlik sorununu çözer)
• Webhook'larınızı mutlaka HTTPS üzerinden çalıştırın
• Token'ları periyodik olarak değiştirin
• Self-hosted kurulumda environment variable'larda saklayın

Ek Güvenlik Önlemleri

• n8n'i reverse proxy (Nginx, Caddy) arkasında HTTPS ile çalıştırın
• Admin UI'ı VPN veya whitelist IP'lerle koruyun
• Webhook endpoint'lerini admin arayüzünden ayırın
• Beklenmedik trafik pattern'lerini izlemek için monitoring kurun

n8n'i Hostinger VPS üzerine kurma rehberimizde reverse proxy ve SSL yapılandırmasını adım adım anlattık.

Hata 5: JSON Veri Tiplerini Anlamamak

JSON veri tipleri, n8n'de en çok hayal kırıklığı yaratan konulardan biridir. Her node verilerini JSON formatında aktarır, bu yüzden JSON'u anlamak n8n'de başarılı olmanın temelidir.

Problem

• "Invalid JSON" hataları
• Beklenmeyen veri formatları
• String/Number/Boolean karışıklıkları
• Array vs Object karmaşası

Yaygın Hatalar

// String beklerken number alma
"123" vs 123

// Array beklerken object alma
{item: "value"} vs [{item: "value"}]

// Null değer yönetimi
undefined vs null vs ""

Çözüm

1. JSON Validator kullanın: Veri formatını kontrol edin
2. Type conversion yapın: Gerektiğinde explicit dönüşüm
3. Set Node ile normalize edin: Veriyi işlemeden önce standartlaştırın
4. IF Node ile null check: Boş değerleri yakalayın ve fallback path oluşturun

Debugging İpuçları:

• Her node'un output'unu Schema sekmesinden inceleyin (veri tiplerini gösterir)
• JSON formatına dikkat edin
• Expression Editor'da veri yapısını kontrol edin
• $json ile node output'larına erişirken dot notation kullanın

Örnek Type Conversion:

// String'i number'a
parseInt({{ $json.value }})

// Number'ı string'e
{{ $json.value }}.toString()

// JSON parse
JSON.parse({{ $json.rawData }})

// Güvenli null check
{{ $json.value ?? "varsayilan" }}

Hata 6: Test Etmeden Production'a Almak

"Çalışıyor gibi görünüyor, deploy edelim" yaklaşımı felakete davetiye çıkarır. n8n'de workflow'u bir kere çalıştırıp "tamam" demek yeterli değildir.

Problem

• Edge case'ler gözden kaçar
• Gerçek verilerle beklenmedik hatalar
• Müşteri deneyimi bozulur
• Geri dönüşü zor durumlar

Çözüm

Sistematik test süreci oluşturun:

1. Manuel Test: Her node'u tek tek "Execute Node" butonu ile test edin
2. Edge Case'ler: Boş veri, null değerler, beklenmedik formatlar gönderin
3. Error Path'ler: Hata senaryolarını kasıtlı olarak tetikleyin
4. Load Test: Yüksek hacimde çalışıp çalışmadığını kontrol edin
5. Pin Data: Test verilerini node'lara pin'leyerek tekrarlanabilir testler oluşturun

Test Checklist'i:

• Tüm node'lar başarılı çalışıyor
• Boş/null veri ile test edildi
• Hata senaryoları test edildi
• Error handling çalışıyor
• Bildirimler doğru gidiyor
• Rate limit'ler kontrol edildi

Staging Ortamı:

• Production'dan ayrı bir n8n instance kurun (Docker ile kurulum rehberi)
• Gerçek veriye benzer test verileri kullanın
• Workflow versiyonlarını karşılaştırın

Hata 7: Workflow'ları İsimlendirmemek ve Dokümante Etmemek

"New Workflow", "Copy of Copy of Workflow" isimleri ile dolu bir workspace, bakım kabusudur. 10 workflow'dan sonra hiçbir şeyi bulamazsınız.

Problem

• Hangi workflow'un ne yaptığı anlaşılmaz
• Yanlış workflow'u düzenleme/silme riski
• Ekip çalışması zorlaşır
• Dokümantasyon imkansız hale gelir

Çözüm

Net ve açıklayıcı isimlendirme kuralları:

1. Format: [Kaynak] - [Aksiyon] - [Hedef]
   • Örnek: Shopify - Yeni Sipariş - Slack Bildirim
2. Prefix kullanımı:
   • PROD_ - Production workflow'ları
   • TEST_ - Test workflow'ları
   • DEV_ - Geliştirme aşamasındakiler
3. Tag ve klasör organizasyonu:
   • Müşteri/proje bazlı tag'ler
   • Fonksiyon bazlı (Lead, Sales, Support) klasörler
   • n8n'in tag sistemi ile workflow'ları kategorize edin

İsimlendirme Örnekleri:

✓ PROD_Stripe - Ödeme Başarılı - CRM Güncelle
✓ PROD_Form - Yeni Lead - Email Serileri Başlat
✓ TEST_API - Webhook Test - Debug Log

✗ New Workflow
✗ Copy of Stripe
✗ asdasd123

Sticky Notes Kullanın

Her workflow'a açıklayıcı Sticky Note ekleyin:

• Workflow'un amacı
• Tetiklenme koşulları
• Bağımlılıklar (hangi sub-workflow'ları çağırıyor)
• Son güncelleme tarihi ve değişiklik notu

Bonus: n8n Best Practice Takvimi

Günlük Rutinler

1. Execution log'larını kontrol edin
2. Hata bildirimlerini inceleyin
3. Kritik workflow'ların çalıştığını doğrulayın

Haftalık Bakım

1. Kullanılmayan workflow'ları disable edin
2. Eski credential'ları temizleyin
3. Error handling'lerin çalıştığını test edin

Aylık Review

1. Workflow performansını analiz edin
2. Güvenlik ayarlarını gözden geçirin
3. Dokümantasyonu güncelleyin
4. n8n sürümünü kontrol edin ve güncelleyin

Sonuç

Bu 7 hatadan kaçınmak, n8n yolculuğunuzda size saatler, hatta günler kazandırır. Önemli olan:

1. Modüler düşünün - büyük workflow'ları sub-workflow'lara parçalayın
2. Güvenliği öncelik yapın - error handling ve webhook güvenliği
3. Sistematik olun - isimlendirme, test ve dokümantasyon

Hatalardan öğrenmek değerli, ama başkalarının hatalarından öğrenmek daha akıllıca!

n8n'de sağlam temeller atmak ve profesyonel workflow'lar oluşturmak için kapsamlı Türkçe eğitimlerimize göz atabilirsiniz. n8n ile yapay zeka otomasyonu ve n8n ile para kazanma rehberlerimize de göz atın.

Sıkça Sorulan Sorular (FAQ)

n8n'de en yaygın hata nedir?

Her şeyi tek bir workflow'a sığdırmaya çalışmak en yaygın hatadır. 50+ node'lu workflow'lar debug etmek ve bakımı yapmak neredeyse imkansız hale gelir. Çözüm olarak sub-workflow'lar kullanarak modüler bir yapı oluşturmalısınız.

n8n workflow'larında error handling nasıl eklenir?

n8n'de error handling için üç ana yöntem vardır: Error Trigger Node ile hata olduğunda ayrı bir workflow başlatabilir, her kritik node'a Error Branch ekleyebilir ve Retry Logic ile geçici hatalar için otomatik yeniden deneme mekanizması kurabilirsiniz. Her workflow'un Settings bölümünden mutlaka bir Error Workflow atamalısınız.

n8n webhook'ları nasıl güvenli hale getirilir?

n8n webhook'larını güvenli hale getirmek için Header Auth, Basic Auth veya JWT Auth yöntemlerinden birini etkinleştirin. Ayrıca HTTPS kullanımı, IP whitelist ve HMAC signature verification gibi ek güvenlik katmanları ekleyebilirsiniz. En azından Header Auth etkinleştirmek, güvenlik sorunlarının %90'ını çözer.

n8n'de JSON hataları neden oluşur?

JSON hataları genellikle veri tipi uyumsuzluklarından kaynaklanır: string beklerken number gelmesi, array beklerken object gelmesi veya null değerlerin yönetilmemesi. Çözüm olarak Set Node ile veriyi normalize edin, type conversion yapın ve her node'un output'unu Schema sekmesinden kontrol edin.

n8n workflow'larını test etmenin en iyi yolu nedir?

Sistematik bir test süreci oluşturun: her node'u tek tek test edin, edge case'leri deneyin (boş veri, null değerler), error path'leri kontrol edin ve Pin Data özelliğiyle tekrarlanabilir testler oluşturun. İdeal olarak production'dan ayrı bir staging n8n instance'ı üzerinde test yapmalısınız.

n8n'de sub-workflow nedir ve nasıl kullanılır?

Sub-workflow, bir workflow'dan çağrılan bağımsız bir başka workflow'dur. Execute Sub-workflow node'u ile büyük süreçleri küçük, yönetilebilir parçalara bölebilirsiniz. n8n 1.97+ sürümlerinde mevcut node'ları seçip sağ tık menüsünden otomatik olarak sub-workflow'a dönüştürebilirsiniz.