HTTP 405 Method Not Allowed Hatası Nedir? Neden Kaynaklanır ve Nasıl Çözülür?

HTTP 405 Method Not Allowed hatası, bir web sunucusunun istemciden gelen HTTP isteğini tanımasına rağmen bu isteği belirli bir kaynak için desteklememesi durumunda ortaya çıkar. Bu hata genellikle bir API çağrısı, form gönderimi veya belirli bir HTTP metodunun (GET, POST, PUT, DELETE vb.) yanlış şekilde kullanılması sonucu meydana gelir.

Bu makalede, HTTP 405 hatasının ne olduğunu, nedenlerini ve nasıl çözülebileceğini adım adım ele alacağız.

HTTP 405 Method Not Allowed Hatası Nedir?

405 hatası, istemcinin kullandığı HTTP metodunun, belirtilen kaynak (örneğin bir URL) tarafından desteklenmediğini belirtir. Tarayıcıda genellikle şu şekilde görüntülenir:

405 Method Not Allowed

Bu hata, sunucunun isteği aldığını ve anlamlandırabildiğini, ancak kullanılan HTTP metoduna izin verilmediğini ifade eder. Örneğin bir form POST metoduyla gönderilirken, sunucu sadece GET isteklerine izin veriyorsa bu hata alınabilir.

HTTP 405 Hatasının Nedenleri

1. Yanlış HTTP Metodu Kullanımı

Web uygulamaları belirli HTTP metodlarını destekleyecek şekilde yapılandırılmıştır. Eğer istemci desteklenmeyen bir metodla istek gönderirse bu hata oluşur.

Örnek:
Bir API uç noktası sadece GET isteklerini kabul ediyorsa ve istemci POST isteği gönderirse 405 hatası dönecektir.

2. Web Sunucusu Yapılandırma Hataları

Apache, NGINX veya IIS gibi sunucu yazılımlarında yapılan yanlış yönlendirme veya metod kısıtlamaları bu hataya neden olabilir. Özellikle .htaccess dosyasında yapılan yanlış ayarlar buna yol açabilir.

3. Yönlendirme Problemleri

Bazen URL yönlendirmeleri sırasında istemci yanlış bir HTTP metodu ile yanlış bir sayfaya yönlendirilir. Örneğin, bir form POST ile gönderildikten sonra GET metodunu desteklemeyen bir sayfaya yönlendirilirse 405 hatası oluşabilir.

4. Framework veya CMS Sınırlamaları

WordPress, Laravel, Django gibi framework’lerde kullanılan yönlendirme sistemleri ya da route tanımlamaları, sadece belirli HTTP metodlarını kabul edecek şekilde yapılandırılmış olabilir.

5. API Güvenlik Katmanları

API üzerinde CORS, rate limit veya firewall gibi güvenlik önlemleri, belirli metodlara izin vermeyerek bu hataya neden olabilir.

HTTP 405 Method Not Allowed Hatası Nasıl Çözülür?

1. HTTP Metodunu Kontrol Edin

Hangi HTTP metodunun kullanıldığını kontrol edin. Eğer bir POST isteğiyle hata alıyorsanız, endpoint gerçekten POST metodunu destekliyor mu kontrol edin. Tarayıcı geliştirici araçlarını veya Postman gibi araçları kullanarak doğru metodla istek gönderdiğinizden emin olun.

2. Sunucu Yapılandırmasını Gözden Geçirin

Apache

.htaccess dosyasında aşağıdaki gibi bir satır varsa kaldırmayı veya düzenlemeyi deneyin:

<LimitExcept GET POST>
  Deny from all
</LimitExcept>

NGINX

NGINX yapılandırma dosyasında şu satırların olup olmadığını kontrol edin:

limit_except GET {
  deny all;
}

Bu tür sınırlamalar varsa kaldırarak hatanın çözülüp çözülmediğini test edin.

3. Uygulama Yönlendirmelerini Kontrol Edin

Uygulama içi yönlendirmelerde kullanılan HTTP metodlarının doğru olduğundan emin olun. Örneğin, bir form POST metoduyla gönderildikten sonra sonucu GET metodunu desteklemeyen bir sayfaya yönlendirmeyin.

4. Route ve Endpoint Ayarlarını İnceleyin

Laravel, Express.js veya Spring gibi sistemlerde route tanımlarını kontrol edin. Aşağıdaki gibi metod kısıtlaması varsa ihtiyaca göre değiştirin:

Route::post('/gonder', 'FormController@submit'); // Sadece POST

Eğer GET istekleri de kabul edilecekse, uygun şekilde tanım yapılmalıdır.

5. Tarayıcı ve Önbellek Temizliği

Bazı durumlarda, tarayıcı önbelleğinde kalan yönlendirme bilgileri HTTP metodlarının yanlış kullanılmasına neden olabilir. Tarayıcı önbelleğini temizleyerek tekrar deneyin.

6. API CORS Ayarlarını Kontrol Edin

Eğer bir API üzerinden işlem yapıyorsanız ve farklı bir domainden istek gönderiyorsanız, CORS ayarlarını kontrol edin. Yanlış yapılandırılmış CORS ayarları da 405 hatasına neden olabilir.

HTTP 405 Hatasını Önlemek İçin İpuçları

• Endpoint tanımlarınızı hem backend hem frontend tarafında net olarak planlayın.
• API belgelerinde hangi metodların kullanılabileceğini açıkça belirtin.
• Web sunucu yapılandırmasını düzenli olarak test edin.
• Formlar ve yönlendirmelerde doğru metodları kullanmaya özen gösterin.
• Geliştirme ve üretim ortamlarında farklı yapılandırmalar kullanıyorsanız testlerinizi her ortamda ayrı ayrı gerçekleştirin.

Sonuç

HTTP 405 Method Not Allowed hatası, genellikle yanlış HTTP metodunun kullanılması sonucu ortaya çıkan bir istemci-sunucu iletişim hatasıdır. Hatanın çözümü, doğru HTTP metodunu belirlemek ve sunucu yapılandırmalarını gözden geçirmekle mümkündür. Özellikle web uygulamaları ve API sistemlerinde metod uyumluluğuna dikkat etmek bu tür hataların önlenmesinde büyük önem taşır.

Bu rehberdeki adımları uygulayarak 405 hatasını kolaylıkla tespit edip çözümleyebilirsiniz.