ASP 500 Internal Server Error hatasının detayını nasıl görebilirim?

IIS üzerinden 'Hata Sayfaları' bölümüne girerek 'Hata Yanıtlarını Düzenle' seçeneğinden 'Ayrıntılı hatalar' (Detailed errors) seçeneğini aktif etmeniz veya web.config dosyasına httpErrors ayarlarını eklemeniz gerekmektedir.

Web.config dosyası ile özel hata sayfası nasıl yapılır?

Web.config dosyanızda etiketi içerisine gibi tanımlamalar ekleyerek özel hata sayfalarını yönetebilirsiniz.

Windows Hosting paketlerinizde ASP desteği var mı?

Evet, Eka Sunucu Windows Hosting paketleri Classic ASP ve en güncel ASP.NET Core sürümlerini tam uyumlu şekilde desteklemektedir.

How to Enable ASP Error Pages? | Windows Server Config 2026 - Eka Sunucu | Turkey's Leading Digital Services Automation Provider

ASP Hata Sayfalarını Yönetin

Windows sunucularda ASP ve ASP.NET projeleriniz için özel hata sayfalarını aktif etmek, 500 Internal Server Error gibi genel hataların detaylarını görmek ve SEO uyumlu 404 sayfaları oluşturmak için ihtiyacınız olan tüm bilgiler burada. 2026 yılı standartlarında, güvenli ve performanslı yapılandırma rehberi.

ASP Hata Sayfaları Neden Önemlidir?

Hata yönetimi sadece teknik bir zorunluluk değil, aynı zamanda kullanıcı deneyimi ve arama motoru optimizasyonunun (SEO) temel taşıdır.

Varsayılan olarak, Windows sunucular (IIS), bir hata oluştuğunda güvenlik nedeniyle ayrıntılı hata mesajlarını gizler ve kullanıcıya genel bir "500 - Internal Server Error" veya "An error occurred on the server" mesajı gösterir. Bu, canlı ortamdaki bir web sitesi için güvenlidir ancak geliştirme aşamasında hatanın kaynağını bulmanızı engeller.

2026 Web Standartlarına Göre Önemli Noktalar:

Güvenlik (Security Through Obscurity): Hata detaylarını sadece kendi IP adresinize (Localhost) göstermeli, dış dünyaya kapatmalısınız.
Kullanıcı Deneyimi (UX): Kullanıcılarınıza "Server Error" yerine, sitenizin tasarımına uygun, yönlendirici "404 Sayfa Bulunamadı" veya "Bakımdayız" sayfaları sunmalısınız.
SEO (E-E-A-T): Google, doğru HTTP durum kodlarını (Status Codes) döndüren ve kullanıcıyı sitede tutan özel hata sayfalarını otorite sinyali olarak algılar.

Yöntem 1: Web.Config ile Yapılandırma

En pratik ve yaygın yöntem, uygulamanızın kök dizinindeki web.config dosyasını düzenlemektir.

ASP.NET Hatalarını Açma (CustomErrors)

ASP.NET tabanlı hataları yönetmek veya detayları görmek için <system.web> bloğu kullanılır. Bu yöntem eski tip ASP.NET hataları için geçerlidir.

web.config

<configuration>
    <system.web>
        <!-- Hataları herkese göstermek için mode="Off" -->
        <!-- Sadece sunucu üzerinde görmek için mode="RemoteOnly" (Önerilen) -->
        <customErrors mode="Off" />
    </system.web>
</configuration>
                        

IIS Hata Sayfalarını Yönetme (httpErrors)

IIS 7.0 ve üzeri sürümlerde (Windows Server 2019, 2022, 2025), statik dosyalar ve Classic ASP dahil tüm hataları yönetmek için <system.webServer> altındaki httpErrors kullanılır. Bu en kapsamlı yöntemdir.

web.config

<configuration>
    <system.webServer>
        <!-- errorMode="Detailed" : Herkese detaylı hata gösterir (Geliştirme ortamı için) -->
        <!-- errorMode="DetailedLocalOnly" : Sadece sunucuya detaylı, dışarıya genel hata gösterir -->
        <httpErrors errorMode="Detailed" existingResponse="PassThrough" />
    </system.webServer>
</configuration>
                        

Uyarı: Canlı (Production) ortamda errorMode="Detailed" bırakmak güvenlik açığı oluşturabilir. Hata kodlarında veritabanı şeması veya dosya yolları ifşa olabilir.

Özel Hata Sayfası Yönlendirmesi (404, 500)

Kullanıcılarınıza profesyonel bir deneyim sunmak için standart IIS hataları yerine kendi tasarladığınız sayfaları gösterin. Bu işlem 2026 SEO standartlarında "Soft 404" hatasına düşmemek için önemlidir.

web.config

<configuration>
    <system.webServer>
        <httpErrors errorMode="Custom" existingResponse="Replace">
            <remove statusCode="404" />
            <error statusCode="404" path="/hatalar/404.asp" responseMode="ExecuteURL" />
            
            <remove statusCode="500" />
            <error statusCode="500" path="/hatalar/500.asp" responseMode="ExecuteURL" />
        </httpErrors>
    </system.webServer>
</configuration>
                        

Yöntem 2: Plesk Panel / IIS Üzerinden Ayarlama

Kod yazmadan, hosting kontrol paneli üzerinden de bu ayarları yapabilirsiniz.

Plesk Panel'e Giriş Yapın: Hosting yönetim panelinize erişin.
Sanal Dizinler / Virtual Directories: İlgili domainin yönetim alanında "Hata Sayfaları" (Error Pages) ikonunu bulun.
Özellik Ayarları: Sağ menüde veya ayarlar sekmesinde "Özellik Ayarlarını Düzenle" (Edit Feature Settings) seçeneğine tıklayın.
Ayrıntılı Hatalar: Açılan pencerede "Ayrıntılı hatalar" (Detailed errors) seçeneğini işaretleyip kaydedin.

Bu işlem sunucu tarafında otomatik olarak web.config dosyanızı güncelleyecektir.

2026 SEO Trendleri ve Hata Sayfaları

Google'ın "Helpful Content" ve "Core Web Vitals" güncellemeleri sonrası hata yönetimi daha da önem kazandı.

Tarama Bütçesi

Doğru 404 yanıtı döndürmeyen sayfalar (Soft 404), arama motoru botlarının zamanını boşa harcar ve sitenizin tarama bütçesini tüketir.

Kullanıcı Güveni

Özel tasarlanmış, site içi arama barı veya popüler linkler içeren bir 404 sayfası, kullanıcının siteden hemen çıkmasını (Bounce Rate) engeller.

Teknik Sağlık

Sürekli 500 hatası veren sayfalar, sitenizin teknik sağlık puanını düşürür ve sıralama kaybına yol açar. Hataları izlemek ve gidermek şarttır.

Windows Hosting Paketlerimiz

ASP ve ASP.NET projeleriniz için yüksek performanslı, NVMe SSD diskli ve %100 uyumlu altyapı.

Windows Başlangıç	1 Web Sitesi	Limitsiz Trafik	Plesk Panel	89,90 ₺ / Ay	İncele
Windows Profesyonel	5 Web Sitesi	Limitsiz Trafik	NVMe SSD	149,90 ₺ / Ay	İncele
Windows Kurumsal	Limitsiz Site	Özel IP Adresi	Premium Destek	299,90 ₺ / Ay	İncele

Daha fazla seçenek için ekonomik paketlerimizi inceleyebilirsiniz.

Sıkça Sorulan Sorular

Classic ASP dosyalarımda "An error occurred on the server" hatası alıyorum, ne yapmalıyım?

Bu genel bir IIS hatasıdır. Hatanın satır numarasını ve sebebini görmek için IIS -> ASP -> Debugging Properties bölümünden "Send Errors To Browser" seçeneğini "True" yapmalısınız. Plesk panelde ise "IIS Ayarları" altında bu seçeneği bulabilirsiniz.

Web.config dosyasını düzenledim ama site 500 hatası veriyor, neden?

Web.config dosyası XML formatındadır ve en ufak bir sözdizimi hatasında (kapatılmamış etiket, yanlış tırnak işareti vb.) siteniz 500.19 hatası vererek çalışmayı durdurur. Dosyayı düzenlemeden önce mutlaka yedeğini alın ve XML validasyonu yapın.

Hosting paketimi değiştirmeden Windows'a geçebilir miyim?

Eğer şu an Linux hosting kullanıyorsanız, Windows hostinge geçiş için paket değişimi yapmanız ve verilerinizi taşımanız gerekmektedir. Eka Sunucu teknik ekibi iletişim kanallarımız üzerinden size bu konuda ücretsiz taşıma desteği sağlayabilir.