Linux Nginx 413 Request Entity Too Large Hatası ve Çözümü

Nginx sunucusu, istemciden gelen isteğin boyutu belirli bir sınırı aştığında "413 Request Entity Too Large" hatası döner. Bu hata, genellikle dosya yükleme işlemlerinde karşılaşılan bir sorundur. Nginx, varsayılan olarak 1MB'lık bir yükleme sınırıyla gelir. Bu sınırı aşan herhangi bir yükleme işlemi, bu hatayla sonuçlanır.

Bu hatanın temel nedeni, sunucu ayarlarında belirlenmiş olan client_max_body_size direktifinin yetersiz kalmasıdır. Bu direktif, istemciden alınabilecek maksimum veri boyutunu kontrol eder. Eğer bu değer artırılmazsa, büyük dosyaların yüklenmesi mümkün olmayacaktır.

Hata Çözümü

Hatanın çözümü için aşağıdaki adımları izleyebilirsiniz:

1. Nginx Konfigürasyon Dosyasını Düzenleyin:

Nginx'in ana konfigürasyon dosyası genellikle /etc/nginx/nginx.conf veya belirli bir site için /etc/nginx/sites-available/your_site.conf dosyasında bulunur. Bu dosyayı bir metin düzenleyici ile açın.

1. client_max_body_size Değerini Ayarlayın:

Dosyanın içinde http, server veya location bloğu içinde client_max_body_size direktifini ekleyin veya mevcutsa değerini artırın. Örneğin, 20MB boyutunu ayarlamak için:

1. Nginx'i Yeniden Başlatın:

Değişikliklerin geçerli olması için Nginx sunucusunu yeniden başlatmalısınız. Bunu yapmak için terminalde aşağıdaki komutu çalıştırın:

1. Doğrulama:

Değişikliklerin başarılı olup olmadığını kontrol etmek için büyük bir dosya yüklemeyi deneyin. Eğer hala aynı hatayı alıyorsanız, konfigürasyon dosyalarını kontrol ederek başka bir yerde client_max_body_size ayarı olup olmadığını kontrol edin.

Nginx'in bu yapılandırması sayesinde, büyük dosyaların yüklenmesi mümkün hale gelecektir. Ancak, dikkat edilmesi gereken nokta, çok büyük dosya yüklemeleri sunucu performansını olumsuz etkileyebilir. Bu nedenle, gerekli sınırları dikkatlice belirlemek önemlidir.

Bu adımları uyguladıktan sonra hala sorun yaşıyorsanız, Nginx hata loglarını incelemek iyi bir uygulama olabilir. Hata logları genellikle /var/log/nginx/error.log dosyasında bulunur ve daha fazla bilgi sağlayabilir.