WordPress Veritabanı Bağlantı Hatası Çözümü

Veritabanı bağlantısı kurulurken hata oluştu (İngilizce arayüzde Error Establishing a Database Connection) mesajı, WordPress kullanıcılarının en sık karşılaştığı arızalardan biridir. Sitenize girdiğinizde içeriğin yerine yalnızca bu tek satırlık beyaz ekranı görürsünüz; çünkü WordPress’in görsel arayüzü ile içeriğin saklandığı MySQL/MariaDB veritabanı arasındaki köprü kopmuştur. WordPress dosyaları (temalar, eklentiler, PHP kodları) sunucuda durur ama her yazı, yorum, ayar ve kullanıcı bilgisi veritabanında tutulduğu için, bağlantı kurulamadığında site açılmaz.

İyi haber şu: bu hata neredeyse her zaman çözülebilir ve çoğu durumda birkaç dakikada giderilir. Aşağıda hatanın gerçek sebeplerini, doğru teşhis sırasını ve her senaryo için adım adım çözümü bulacaksınız. Panik yapıp dosyaları silmeden önce bu rehberi sırayla uygulamanız, hem zaman kazandırır hem de mevcut verilerinizi korur.

Hata Tam Olarak Ne Anlama Geliyor?

WordPress her sayfa isteğinde önce veritabanına bağlanmaya çalışır. Bu bağlantı için dört bilgiye ihtiyaç duyar ve bu bilgiler wp-config.php dosyasında tanımlıdır: veritabanı adı, veritabanı kullanıcı adı, kullanıcı şifresi ve veritabanı sunucu adresi (host). Bu dörtlüden herhangi biri yanlışsa ya da veritabanı servisi cevap vermiyorsa, WordPress bağlantıyı kuramaz ve hatayı ekrana basar.

Önemli bir ayrım var: bazen ana sayfa açılır ama yönetim paneline (/wp-admin) girince “Bir veya daha fazla veritabanı tablosu kullanılamıyor. Veritabanının onarılması gerekebilir” uyarısını görürsünüz. Bu, bağlantının kurulduğu ama tabloların bozulduğu anlamına gelir ve çözümü farklıdır. Önce hangi durumda olduğunuzu netleştirin.

Hataya Sebep Olan Başlıca Durumlar

• Veritabanı adı, kullanıcı adı veya şifresinin wp-config.php dosyasında yanlış yazılmış olması,
• Bu bilgilerden birinin sonradan (örneğin panelden şifre değiştirilerek) güncellenmiş ama wp-config.php’ye yansıtılmamış olması,
• Veritabanı sunucusunun (MySQL/MariaDB servisinin) çalışmaması ya da yanıt vermemesi,
• DB_HOST değerinin yanlış olması (çoğu paylaşımlı hostingde localhost doğrudur, ancak bazı kurulumlarda farklı bir adres gerekir),
• “Too many connections” yani sunucunun aynı anda izin verdiği bağlantı sayısının dolması (genelde trafik artışı veya kontrolsüz eklentiler yüzünden),
• Veritabanı tablolarının bozulması (ani güç kesintisi, dolu disk veya yarım kalan güncelleme sonrası),
• Hatalı bir eklenti/tema güncellemesi ya da hacklenmiş site dosyaları.

Bu sebepler, Veritabanı bağlantısı kurulurken hata oluştu (Error Establishing a Database Connection) mesajıyla karşılaşmanıza yol açan durumların en yaygın olanlarıdır. Şimdi bunları teşhis sırasına göre tek tek çözelim.

Adım 1: wp-config.php Bilgilerini Doğrulayın

İlk ve en kritik adım budur, çünkü vakaların büyük çoğunluğu bu dosyadaki hatalı bir değerden kaynaklanır. FTP, SFTP veya hosting kontrol panelinizdeki Dosya Yöneticisi ile WordPress’in kurulu olduğu dizine gidin ve wp-config.php dosyasını bir metin düzenleyicide açın. Şu dört satırı bulun:

• define(‘DB_NAME’, ‘veritabani_adi’); — WordPress’in kullandığı veritabanının adı,
• define(‘DB_USER’, ‘kullanici_adi’); — bu veritabanına erişen MySQL kullanıcısı,
• define(‘DB_PASSWORD’, ‘sifre’); — o kullanıcının şifresi,
• define(‘DB_HOST’, ‘localhost’); — veritabanı sunucusunun adresi.

Bu değerleri, hosting panelinizdeki gerçek veritabanı bilgileriyle harf harf karşılaştırın. cPanel kullanıyorsanız tam veritabanı adının ve kullanıcı adının genellikle bir hesapadi_ önekiyle başladığını unutmayın (örneğin musteri1_wp). En sık yapılan hatalar şunlardır: baştaki/sondaki boşluklar, büyük-küçük harf farkı ve kopyalarken araya karışan görünmez karakterler. Şifrede özel karakter varsa, yanlış kaydedilmiş olma ihtimaline karşı bir sonraki adımda şifreyi sıfırlamak en güvenli yoldur.

Adım 2: Veritabanı Şifresini Sıfırlayın ve Eşitleyin

Şifrenin doğru olduğundan emin olmanın en garantili yolu, şifreyi yeniden belirleyip hem panelde hem wp-config.php’de aynı değeri kullanmaktır. Alastyr müşterisiyseniz şu adımları izleyin:

siteadresiniz.com:2082 adresinden kontrol panelinize giriş yapın. Şifrenizi hatırlamıyorsanız müşteri panelinizden size son gönderilen e-postaları kontrol edebilirsiniz; hosting teslim e-postasında giriş bilgileri yer alır.

Giriş yaptıktan sonra Databases (Veritabanları) > MySQL Veritabanları bölümüne tıklayarak veritabanı yönetim sayfasını açın. Sayfanın en altında Geçerli Kullanıcılar (Current Users) bölümüne gelin, WordPress kurulu veritabanına bağlı kullanıcının yanındaki Şifreyi Değiştir (Change Password) butonuna tıklayın. Yeni ve güçlü bir şifre belirleyin, bu şifreyi mutlaka bir yere not edin.

Ardından FTP/Dosya Yöneticisi ile wp-config.php dosyasını tekrar açın ve DB_PASSWORD satırındaki şifreyi az önce belirlediğiniz yeni şifreyle değiştirip kaydedin. Bu noktada veritabanı tablo ön ekinin ($table_prefix = ‘wp_’; satırı) ve diğer üç değerin de doğru olduğundan emin olun. Sayfayı yenileyin; çoğu durumda site bu adımdan sonra açılır.

Adım 3: DB_HOST Değerini Kontrol Edin

Kimlik bilgileri doğru olduğu halde hata sürüyorsa, problem büyük ihtimalle DB_HOST değerindedir. Bu değer, WordPress’e MySQL sunucusunun nerede olduğunu söyler. Paylaşımlı hosting ortamlarının neredeyse tamamında web sunucusu ile veritabanı sunucusu aynı makinede çalıştığından doğru değer localhost‘tur.

Ancak bazı kurulumlarda (özellikle veritabanının ayrı bir sunucuda tutulduğu yapılar veya bazı bulut/VPS senaryoları) host değeri farklı olabilir: 127.0.0.1, bir IP adresi ya da localhost:3306 gibi port içeren bir değer gerekebilir. Hangi değerin doğru olduğundan emin değilseniz, paylaşımlı hosting kullanıyorsanız önce localhost‘u deneyin; çalışmıyorsa hosting sağlayıcınızın doğru host bilgisini sorun. Alastyr’da 7/24 destek ekibi bu bilgiyi anında verir.

Adım 4: Veritabanı Sunucusu Çalışıyor mu?

wp-config.php’deki her şey doğruysa ama hata devam ediyorsa, MySQL/MariaDB servisi geçici olarak durmuş ya da bağlantı limitine takılmış olabilir. Bunu anlamanın hızlı bir yolu vardır: aynı hesapta başka bir WordPress siteniz varsa onun da aynı anda hata verip vermediğine bakın. Hepsi birden çöktüyse, sorun büyük olasılıkla site dosyalarında değil sunucu tarafındadır.

Paylaşımlı hostingde MySQL servisini yeniden başlatmak sizin elinizde olmayabilir; bu durumda en doğru hamle, durumu hosting sağlayıcınıza bildirmektir. Alastyr altyapısında MySQL servisleri 7/24 izlenir ve gerektiğinde anında müdahale edilir. Kendi VPS ya da bulut sunucunuzu yönetiyorsanız, SSH ile bağlanıp servis durumunu kontrol edebilir ve gerekirse yeniden başlatabilirsiniz.

“Too Many Connections” Hatası

Hata mesajının yanında ya da loglarda Too many connections ifadesini görüyorsanız, sebep açıktır: veritabanı sunucusu, aynı anda izin verilen maksimum bağlantı sayısına ulaşmıştır ve yeni isteklere “hayır” demektedir. Bu durum genellikle iki nedenden olur: sitenize beklenmedik bir trafik geldiğinde, ya da bağlantıları düzgün kapatmayan kötü kodlanmış bir eklenti bağlantı havuzunu doldurduğunda.

Geçici çözüm sayfayı bir süre sonra yenilemektir; ancak bu tekrar ediyorsa altyapı yetersiz kalıyor demektir. Bu noktada ya bağlantıyı şişiren eklentiyi bulup devre dışı bırakmanız, ya da daha güçlü, izole kaynaklara sahip bir pakete geçmeniz gerekir. Alastyr’ın CloudLinux + CageFS altyapısında her hesap kendi kaynak sınırlarıyla izole edilir; böylece komşu bir hesabın yoğunluğu sizin sitenizi çökertmez. Yoğun trafikli projeler için VPS veya bulut sunucu, MySQL bağlantı limitini kendiniz ayarlama özgürlüğü sunar.

Bozuk Veritabanı Tablolarını Onarma

Ana sayfa açıldığı halde /wp-admin tarafında “Veritabanının onarılması gerekebilir” uyarısını alıyorsanız, bağlantı sağlıklıdır ama bir veya daha fazla tablo bozulmuştur. WordPress’in bu iş için yerleşik bir onarım aracı vardır. Aktifleştirmek için wp-config.php dosyasına, /* That's all, stop editing! */ satırından önce şunu ekleyin:

• define(‘WP_ALLOW_REPAIR’, true);

Sonra tarayıcınızdan siteadresiniz.com/wp-admin/maint/repair.php adresine gidin. Karşınıza çıkan ekranda “Veritabanını Onar” veya “Onar ve Optimize Et” seçeneklerini göreceksiniz. Onarımı çalıştırın. İşlem bittikten sonra güvenlik gerekçesiyle bu satırı wp-config.php’den mutlaka silin; çünkü açık kaldığı sürece bu sayfaya giriş yapmadan herkes erişebilir.

Daha ileri seviye bir yöntem olarak phpMyAdmin üzerinden de onarım yapabilirsiniz: cPanel’de phpMyAdmin’i açın, ilgili veritabanını seçin, tablo listesinin altındaki kutucuktan tüm tabloları işaretleyin ve “Seçilenlerle (With selected)” menüsünden Tabloyu onar (Repair table) komutunu çalıştırın. Burada önemli bir teknik not: REPAIR TABLE komutu yalnızca MyISAM tabloları için çalışır; modern WordPress kurulumlarında varsayılan olan InnoDB motoru bu komutu desteklemez. InnoDB tabloları bozulduğunda genellikle bir yedekten geri dönmek en sağlıklı çözümdür. Bu yüzden günlük yedekleme her zaman hayati önem taşır.

Hata Devam Ederse: İleri Düzey Adımlar

Yukarıdakilerin hiçbiri işe yaramadıysa, geriye birkaç ihtimal kalır. Birincisi, wp-config.php dosyasının kendisinin bozulması olabilir; özellikle başka eli değmiş, hacklenmiş kurulumlarda bu görülür. WordPress’in temiz bir kopyasından alacağınız wp-config-sample.php dosyasını referans alarak kendi bilgilerinizi yeniden girip yeni bir wp-config.php oluşturmak sorunu çözebilir.

İkinci ihtimal, PHP bellek limitinin dolmasıdır. wp-config.php’ye define(‘WP_MEMORY_LIMIT’, ‘256M’); satırını ekleyerek belleği artırabilirsiniz. Üçüncü olarak, kötü amaçlı yazılım ya da bozuk bir eklenti veritabanını sürekli şişiriyor olabilir; bu noktada bir güvenlik taraması ve temiz yedekten geri dönüş gündeme gelir. Alastyr altyapısında Imunify360 tabanlı çift katmanlı koruma ve günlük yedekleme sayesinde bu tür durumlarda geri dönüş hızlı ve sorunsuzdur. Hiçbir şey işe yaramadığında, doğru ve hızlı yol her zaman destek ekibine ulaşmaktır.

Bu Hatadan Tamamen Kurtulmanın Yolu: Sağlam Altyapı

Bu hatanın arkasındaki sebeplerin önemli bir kısmı (yetersiz bağlantı limiti, MySQL servisinin sık çökmesi, disk dolması, izolasyonsuz komşu hesapların kaynak tüketmesi) doğrudan hosting altyapısının kalitesiyle ilgilidir. İzmir’deki kendi veri merkezimizde, N+1 yedekli enerji ve soğutma altyapısı, all-flash depolama ve CloudLinux izolasyonuyla çalışan bir ortamda, “veritabanı çöktü” senaryolarının sıklığı çok düşüktür. WordPress için optimize edilmiş LiteSpeed + LSCache mimarisi, veritabanı yükünü hafifleterek bağlantı limitlerine takılma olasılığını da azaltır.

2002’den beri %100 Türk sermayesiyle hizmet veren, 45 binden fazla hosting hesabını barındıran bir ekiple çalışmak, bu tür kriz anlarında 7/24 yanınızda gerçek bir destek bulmak demektir.

Sıkça Sorulan Sorular

WordPress veritabanı bağlantı hatası neden oluşur?

En yaygın sebep, wp-config.php dosyasındaki veritabanı adı, kullanıcı adı, şifre veya host bilgisinin yanlış olmasıdır. Bunun dışında MySQL servisinin çökmesi, bağlantı limitinin dolması (Too many connections) veya tabloların bozulması da bu hatayı tetikleyebilir.

Veritabanı bağlantı hatası nasıl düzeltilir?

Önce wp-config.php dosyasındaki DB_NAME, DB_USER, DB_PASSWORD ve DB_HOST değerlerini hosting panelindeki gerçek bilgilerle karşılaştırın. Şifreden emin değilseniz panelden sıfırlayıp wp-config.php’ye aynı şifreyi girin. Bilgiler doğruysa DB_HOST değerini (genellikle localhost) ve MySQL servisinin çalışıp çalışmadığını kontrol edin.

wp-config.php dosyası nerede bulunur?

wp-config.php, WordPress’in kurulu olduğu ana dizinde (genellikle public_html içinde) yer alır. Dosyaya FTP/SFTP istemcisiyle ya da hosting panelinizdeki Dosya Yöneticisi ile erişebilirsiniz.

DB_HOST değeri ne olmalı?

Paylaşımlı hostinglerin çoğunda doğru değer localhost’tur. Bazı kurulumlarda 127.0.0.1, bir IP adresi ya da port içeren localhost:3306 gibi bir değer gerekebilir. Emin değilseniz hosting sağlayıcınızdan doğru host bilgisini öğrenin.

Veritabanı şifresini nasıl sıfırlarım?

cPanel’de Databases > MySQL Veritabanları bölümüne girin, Geçerli Kullanıcılar kısmında ilgili kullanıcının yanındaki Şifreyi Değiştir butonuna tıklayın, yeni şifreyi belirleyin ve aynı şifreyi wp-config.php dosyasındaki DB_PASSWORD satırına yazın.

Bozuk veritabanı tabloları nasıl onarılır?

wp-config.php dosyasına define(‘WP_ALLOW_REPAIR’, true); satırını ekleyip siteadresiniz.com/wp-admin/maint/repair.php adresinden onarımı çalıştırın. İşlem bitince güvenlik için bu satırı silin. phpMyAdmin üzerinden de tabloları seçip Repair table komutu kullanılabilir; ancak bu komut yalnızca MyISAM tabloları için geçerlidir.

“Too many connections” hatası ne demek?

Veritabanı sunucusunun aynı anda kabul ettiği maksimum bağlantı sayısının dolduğu anlamına gelir. Genellikle ani trafik artışı veya bağlantıları kapatmayan kötü kodlanmış bir eklenti yüzünden olur. Tekrar ediyorsa eklentileri gözden geçirmeniz ya da daha güçlü, izole kaynaklı bir pakete geçmeniz gerekir.

Hata sadece yönetim panelinde çıkıyorsa ne yapmalıyım?

Ana sayfa açılıp /wp-admin tarafında “veritabanının onarılması gerekebilir” uyarısı çıkıyorsa, bağlantı sağlıklı ama tablolar bozuk demektir. Bu durumda WP_ALLOW_REPAIR aracını veya phpMyAdmin onarımını kullanın, gerekirse temiz bir yedekten geri dönün.

Bu hatayı önlemek için ne yapabilirim?

Düzenli yedekleme almak, güvenilir eklentiler kullanmak ve yeterli kaynak ile izolasyon sunan bir hosting altyapısı seçmek hatanın tekrarını büyük ölçüde engeller. Günlük yedekleme ve CloudLinux izolasyonu olan bir ortamda hem hata sıklığı azalır hem de bir sorun çıktığında geri dönüş çok hızlı olur.