Sorun Giderme Rehberi

Bu rehber, Teydex KYC projesinde karşılaşılabilecek yaygın kurulum ve çalışma zamanı hatalarını ve bunların nasıl çözüleceğini açıklar.

---

Erişim Kontrol Başlıkları

Bu başlıklar web uygulaması mantığı için gereklidir ve gelen isteklerde ayarlanmış olmalıdır. Bu alanlar üzerine yazılmamalıdır; eğer manuel olarak güncellenecekse, aşağıdaki değerler korunarak güncellenmelidir.

Access-Control-Allow-Headers:

accept, authorization, content-type, user-agent, x-csrftoken, x-requested-with

Access-Control-Allow-Methods:

DELETE, GET, OPTIONS, PATCH, POST, PUT

413 Request Entity Too Large

Bu Hata Nedir?

413 Request Entity Too Large hatası, istemcinin gönderdiği istek gövdesi web sunucusu veya proxy tarafından izin verilen maksimum boyutu aştığında meydana gelir. Genellikle şu durumlarda ortaya çıkar:

• Dosya yüklemeleri (görseller, videolar, PDF’ler, vb.)
• Büyük JSON verileri veya form gönderimleri

NGINX varsayılan olarak düşük bir istek boyutu limiti tanımlar, bu da büyük yüklemeleri engelleyebilir.

Çözüm Örneği (NGINX)

Daha büyük istekleri kabul edebilmek için NGINX yapılandırmasında client_max_body_size yönergesini artırmanız gerekir.

Adım Adım:

1. NGINX yapılandırma dosyasını açın

   Sisteminize göre dosya şuralarda olabilir:

   • /etc/nginx/nginx.conf
   • /etc/nginx/conf.d/default.conf
   • /etc/nginx/sites-available/siteniz

2. client_max_body_size değerini ayarlayın

   Yapılandırmaya göre http, server veya location bloğu içine ekleyin:

   server {
       client_max_body_size 10M;
       # ... diğer ayarlar ...
   }

   Tüm sunucuya global olarak uygulamak isterseniz http bloğuna yazabilirsiniz:

   http {
       client_max_body_size 10M;
       # ...
   }

3. NGINX’i yeniden başlatın

   Dosyayı kaydettikten sonra değişikliklerin geçerli olması için NGINX’i yeniden başlatın:

   sudo systemctl restart nginx

Son Notlar

• Seçtiğiniz boyut, kullanıcı ihtiyacı ile sunucu güvenliği arasında bir denge kurmalıdır. Genellikle 5M ile 50M arası tercih edilir.
• Değişikliklerden sonra mutlaka NGINX’i yeniden başlatın.
• Eğer Traefik veya Caddy gibi bir ters proxy kullanıyorsanız, onların yükleme limitlerini de güncelleyin.