"413 Request Entity Too Large": Payload Sınırlarını Artırma (SSS)

n8n'de "413 Request Entity Too Large" hatası genellikle bir webhook, örneğin bir PDF, bir görsel veya kapsamlı bir JSON payload gibi daha büyük bir dosya aldığında ve yapılandırılmış üst sınır aşıldığında ortaya çıkar. n8n burada varsayılan olarak payload başına 16 MiB'lik bir sınır belirler ve bu sınır tek bir ortam değişkeni üzerinden yükseltilebilir. Ancak birçok durumda asıl darboğaz n8n'in kendisinde değil, ondan önceki bir katmanda, yani ters proxy'de bulunur. Güncelleme: Temmuz 2026.

Bu SSS makalesi, hangi değişkeni ayarlamanız gerektiğini, n8n'e özgü bir sınır ile proxy sınırını nasıl ayırt edeceğinizi ve örneğinizin kararlı kalması için sınırı yükseltirken nelere dikkat etmeniz gerektiğini gösterir.

n8n'de 413 hatası tam olarak ne anlama gelir?

413 HTTP durum kodu, payload'ı izin verilenden büyük olduğu için sunucunun gelen isteği reddettiğini bildirir. n8n'de bu sınır özellikle iki noktada devreye girer:

• Webhook tetikleyicileri, form, sohbet widget'ı veya harici sistemler gibi dışarıdan dosya veya büyük JSON gövdeleri alan.
• İç işleme bir workflow içindeki büyük veri kümelerinin, bir node'un yapılandırılmış üst sınırı aşan bir sonuç döndürmesi durumunda.

Kaynağa göre, Endpoint ortam değişkenlerine ilişkin n8n dokümantasyonu, varsayılan sınır 16 MiB'dir. Metin verileri, küçük görseller veya normal API yanıtları içeren çoğu otomasyon için bu yeterlidir. Ancak bir workflow üzerinden PDF'ler, yüksek çözünürlüklü görseller veya çok sayfalı belgeler geçtiğinde sınıra hızla ulaşılır.

Merkezi ortam değişkeni: N8N_PAYLOAD_SIZE_MAX

Belirleyici ayar N8N_PAYLOAD_SIZE_MAXolarak adlandırılır. Maksimum payload boyutunu MiB cinsinden tanımlar ve resmi dokümantasyonagöre varsayılan olarak 16'ya ayarlanmıştır. Sınırı yükseltmek için değişkeni daha yüksek bir değere ayarlayın, örneğin:

• `N8N_PAYLOAD_SIZE_MAX=64` 64 MiB için
• `N8N_PAYLOAD_SIZE_MAX=128` 128 MiB için

Docker kurulumunda değişkeni Compose dosyanıza veya Docker run ortamına ekleyin, npm kurulumunda ise başlatmadan önce ayarlayın, örneğin `N8N_PAYLOAD_SIZE_MAX=64 n8n` üzerinden. Önemli: Değişken ayarlandıktan sonra değişikliğin etkili olması için n8n örneğinin yeniden başlatılması gerekir. Web arayüzünün basitçe yeniden yüklenmesi yeterli değildir.

Dosyalarla yapılan form yüklemeleri için ayrıca ayrı bir değişken daha vardır: N8N_FORMDATA_FILE_SIZE_MAX, aynı dokümantasyona göre varsayılan olarak 200 MiB'dir ve özellikle form-data payload'ları içindeki dosya boyutunu düzenler, örneğin bir webhook bir formdan dosya yüklemeleri aldığında. Daha büyük dosya eklerine özellikle izin vermek istiyorsanız her iki değişkeni de kontrol edin ve birbiriyle uyumlu hale getirin.

Değişkeni ayarlamak bazen neden yeterli olmuyor

n8n topluluğundan yaygın bir tuzak: Değişken doğru ayarlanmıştır ancak hata yine de devam eder. Bunun nedeni neredeyse her zaman, isteği n8n'e ulaşmadan önce yakalayan önceki bir örnektir. PDF'lerin webhook üzerinden yüklenmesinde 413 hatalarına ilişkin bir topluluk konusundabu örüntü doğrulanır: İsteği sınırlayan n8n'in kendisi değil, önündeki Nginx yapılandırmasıydı, oysa n8n'e özgü sınır çok daha yüksekti.

Bu nedenle sırasıyla şunları kontrol edin:

• Ters proxy olarak Nginx:`client_max_body_size` direktifi, gövde boyutunu n8n'den bağımsız olarak sınırlar. Sunucu veya location yapılandırmasındaki `client_max_body_size 100M;` gibi bir değer, n8n sınırıyla eşleşmeli veya daha cömert olmalıdır.
• Traefik veya Cloudflare Tunnel:Burada da istek gövdeleri için ayrıca yapılandırılması gereken kendi üst sınırları vardır.
• Önünde load balancer bulunan Docker kurulumları:Bulut load balancer'ları genellikle n8n'den bağımsız olarak geçerli olan, bazen daha düşük, kendi varsayılan sınırlarını getirir.

Ancak tüm katmanlar, yani hem proxy hem de n8n'in kendisi, yeterince yüksek bir sınıra ayarlandığında 413 hatası güvenilir bir şekilde ortadan kalkar. n8n topluluk forumundakiartık çözülmüş eski bir vakada nedenin, ayarlanan sınırdan bağımsız olarak payload'ları daha 100 KB'de engelleyen daha önceki bir n8n sürümündeki bir hata olduğu bile ortaya çıkmıştı. Güncel bir n8n sürümüne güncelleme, bu tür eski sorunları da güvenilir bir şekilde giderir.

Sınırları genel olarak maksimize etmek yerine bilinçli belirleyin

Sınırı refleks olarak çok yüksek bir değere ayarlamadan önce, madalyonun diğer yüzüne kısaca bakmakta fayda var. Dokümantasyon, daha yüksek bir payload sınırının daha fazla bellek ve daha fazla işlem gücü gerektirdiğini ve tüm örneğin performansını etkileyebileceğini açıkça belirtir. Üretimde çok sayıda paralel workflow ile çalışanlar, sınırı bu nedenle teorik olarak mümkün olana değil, gerçek ihtiyaca göre ayarlamalıdır.

Birkaç pratik yönerge:

• Değeri mümkün olduğunca yüksek değil, gerektiği kadar yüksek ayarlayın. PDF işleme için genellikle 32 ila 64 MiB yeterlidir, video verileri için daha fazlası gerekebilir.
• Ayarlamadan sonra, özellikle sınırlı kaynaklara sahip self-hosting durumunda, örneğinizin bellek tüketimini gözlemleyin.
• Mümkün olduğunda büyük payload sınırlarını, büyük dosyaları bellekte tutmak yerine ikili veriler için dosya sistemi moduile birleştirin; bu, N8N_DEFAULT_BINARY_DATA_MODE üzerinden kontrol edilir. Dokümantasyona göre n8n, ikili verileri varsayılan olarak "default" modunda bellekte tutar, bu da büyük payload'larda hızla bellek baskısına yol açar.

Bir n8n örneğini üretimde işleten ve her altyapı konusunu kendisi araştırmak istemeyen kişiler, yapılandırma, izleme ve sorun giderme işlemlerini NordFlux'un n8n danışmanlığı ve desteğikapsamında dışarıya devredebilir. Teknik ince ayar arka planda yürütülürken workflow'larınız ve verileriniz üzerindeki kontrolü elinizde tutarsınız.

Sık sorulan sorular

n8n'de payload sınırını hangi ortam değişkeni artırır?

Değişken: N8N_PAYLOAD_SIZE_MAX maksimum payload boyutunu MiB cinsinden belirler ve n8n dokümantasyonunagöre varsayılan olarak 16'dır. Değişkeni daha yüksek bir değere ayarlayıp ardından örneği yeniden başlatarak artırırsınız.

N8N_PAYLOAD_SIZE_MAX değerini artırmama rağmen neden hâlâ 413 hatası alıyorum?

Bu durumların çoğunda, n8n'in önünde örneğin `client_max_body_size` içeren bir Nginx yapılandırmasında, Traefik'te veya önceki bir load balancer'da başka bir sınır bulunur. n8n'in kendisi isteğe belki de zaten izin veriyordur, ancak proxy onu önceden engeller. Bu nedenle altyapının her katmanını ayrı ayrı kontrol edin.

N8N_PAYLOAD_SIZE_MAX ile N8N_FORMDATA_FILE_SIZE_MAX arasındaki fark nedir?

N8N_PAYLOAD_SIZE_MAX, n8n'e yapılan bir isteğin toplam boyutunu sınırlar. N8N_FORMDATA_FILE_SIZE_MAX ise özellikle form-data payload'ları içindeki maksimum dosya boyutunu düzenler, örneğin bir webhook formu üzerinden dosya yüklemelerinde, ve varsayılan olarak 200 MiB'dir. Yalnızca formlar üzerinden yapılan dosya yüklemeleri için genellikle bu ikinci değişken önemlidir.

Değişkeni ayarladıktan sonra n8n'i yeniden başlatmam gerekir mi?

Evet. N8N_PAYLOAD_SIZE_MAX gibi ortam değişkenleri, n8n sürecinin başlangıcında okunur. Web arayüzünü yeniden yüklemek yeterli değildir; yeni sınırın etkili olması için örnek, yani container, yeniden başlatılmalıdır.

Sınırı çok yüksek ayarlamanın dezavantajları var mı?

Evet. Dokümantasyona göre daha yüksek bir payload sınırı, bellek ve işlem gücü ihtiyacını artırır ve tüm örneğin performansını etkileyebilir. Bu nedenle sınırı genel olarak çok yüksek bir değere değil, bilinçli olarak gerçek ihtiyaca göre ayarlayın.