WordPress veritabanı bağlantısı kurulamadı hatası nasıl çözülür?

Kısa yanıt

WordPress’te “Veritabanı bağlantısı kurulurken hata oluştu” mesajı, sitenizin dosyaları veritabanınıza erişemediğinde çıkar; en sık nedenleri wp-config.php içindeki yanlış kullanıcı adı/parola bilgileri, yanıt vermeyen bir veritabanı sunucusu, dolu bir disk kotası veya bozulmuş veritabanı tablolarıdır. Doğru sırayla ilerlendiğinde bu veritabanı bağlantısı kurulamadı hatası genellikle 15-20 dakika içinde, veri kaybı olmadan çözülür.

Kötü haber gibi görünse de çoğu zaman veritabanınızın kendisi zarar görmemiştir; sorun neredeyse her zaman bağlantı bilgilerinde veya sunucu erişiminde saklıdır. İlk yapılacak şey panik yapıp dosya silmek değil, wp-config.php dosyasını ve hosting panelindeki veritabanı durumunu sırayla kontrol etmektir.

WordPress veritabanı bağlantısı kurulamadı hatası neden oluşur

Bu hatanın görünüşü tektir (beyaz ekranda tek satırlık bir mesaj) ama nedeni birkaç farklı katmandan gelebilir. En sık karşılaşılan tetikleyiciler şunlardır:

• Hosting sağlayıcısı tarafında veritabanı parolasının değiştirilmesi, ama bu değişikliğin wp-config.php dosyasına yansıtılmaması
• Site başka bir sunucuya taşınırken DB_HOST değerinin eski sunucuyu göstermeye devam etmesi
• Veritabanı sunucusunun (MySQL/MariaDB) aşırı yük, kaynak kotası aşımı veya geçici bir kesinti nedeniyle yanıt vermemesi
• Veritabanı tablolarının ani bir kapanma, hatalı bir eklenti sorgusu veya disk sorunu sonucu bozulması
• Veritabanı kullanıcısının, ilgili veritabanı üzerindeki yetkilerinin (privileges) hosting panelinde yanlışlıkla kaldırılması

Ortak nokta, sorunun WordPress’in kendisinde değil, WordPress ile veritabanı arasındaki köprüde olmasıdır. Bu yüzden çözüm arayışı da her zaman aynı sırayla ilerlemelidir: önce bilgiler doğru mu, sonra sunucu ayakta mı, en son da veritabanının kendisi sağlam mı.

Hatanın nerede göründüğüne dikkat edin

Veritabanı bağlantısı kurulamadı hatasını çözmeye başlamadan önce, mesajın tam olarak nerede çıktığına bakmak size zaman kazandırır. Hata yalnızca ön yüzde (ziyaretçilerin gördüğü sayfalarda) görünüyor ama /wp-admin/ paneline giriş yapabiliyorsanız, sorun genellikle önbellek eklentisi veya belirli bir sorguyla sınırlıdır. Hata hem site hem de yönetim panelinde görünüyorsa, bağlantı sorunu daha temel bir seviyededir ve aşağıdaki adımların tamamını sırayla uygulamanız gerekir.

Bu ayrım önemlidir çünkü ikinci durumda WordPress, veritabanına hiç ulaşamadığı için normal hata ayıklama (WP_DEBUG) araçları da devreye giremez; bu yüzden aşağıdaki kontroller manuel olarak, dosya yöneticisi veya FTP üzerinden yapılmalıdır.

wp-config.php dosyasındaki veritabanı bilgilerini kontrol edin

Bu hatayı çözmenin en yaygın ve en etkili yolu, wp-config.php dosyasındaki bağlantı bilgilerini hosting panelinizdeki gerçek veritabanı bilgileriyle karşılaştırmaktır. FTP veya hosting dosya yöneticinizle site kök dizinindeki wp-config.php dosyasını açın ve şu dört satırı bulun:

define( 'DB_NAME', 'veritabani_adi' );
define( 'DB_USER', 'kullanici_adi' );
define( 'DB_PASSWORD', 'parola' );
define( 'DB_HOST', 'localhost' );

Hosting panelinizin veritabanları bölümüne (cPanel, hPanel veya benzeri) girip veritabanı adını, kullanıcı adını doğrulayın; parolayı hatırlamıyorsanız panelden yeni bir parola belirleyip aynı değeri wp-config.php içine de yazın. Tek bir karakter farkı (fazladan boşluk, yanlış tırnak) bile bu hatayı tetikleyebileceği için, bilgileri kopyala-yapıştır ile taşımak elle yazmaktan daha güvenlidir.

Veritabanı kullanıcısının yetkilerini doğrulayın

Bilgiler doğru göründüğü halde hata devam ediyorsa, sıradaki adım kullanıcının veritabanı üzerindeki yetkileridir. Bazı hosting panellerinde bir veritabanı kullanıcısı oluşturmak, onu otomatik olarak ilgili veritabanına bağlamaz; bu iki adımın ayrı ayrı yapılması gerekir. Panelinizin “Veritabanı Kullanıcıları” veya “MySQL Kullanıcıları” bölümünden, kullanıcının doğru veritabanına “Tüm Yetkiler” (All Privileges) ile eklenmiş olduğunu kontrol edin.

Bu adım özellikle site bir sunucudan diğerine taşındığında veya veritabanı elle yeniden oluşturulduğunda atlanan bir noktadır; kullanıcı var, veritabanı var, ama ikisi arasındaki yetki bağı eksik kalmıştır.

DB_HOST değerini ve veritabanı sunucusunun durumunu kontrol edin

DB_HOST çoğu paylaşımlı hostingde “localhost” olur, ama bu her zaman doğru değildir; bazı sağlayıcılar (özellikle yönetilen WordPress hostingi veya ayrı bir veritabanı sunucusu kullanan altyapılar) 127.0.0.1 gibi bir IP adresi veya db.saglayici.com benzeri özel bir sunucu adı kullanır. Doğru DB_HOST değerini hosting sağlayıcınızın kurulum e-postasında veya panelin veritabanı bölümünde bulabilirsiniz.

DB_HOST doğruysa ama hata sürüyorsa, veritabanı sunucusunun kendisinin ayakta olup olmadığına bakın. Hosting panelinizin durum sayfasından MySQL/MariaDB servisinin çalıştığını doğrulayın; paylaşımlı hostingde ani trafik artışları veya kaynak kotası aşımı, veritabanı sunucusunun geçici olarak yanıt vermemesine yol açabilir. Bu durumda WordPress tarafında yapabileceğiniz bir şey yoktur, sorun hosting altyapısındadır.

WordPress’in veritabanı onarım aracını kullanın

Bilgiler ve sunucu durumu doğruysa ama hata devam ediyorsa, sıra veritabanı tablolarının kendisine gelir. WordPress, bunun için yerleşik bir onarım aracı sunar. Önce wp-config.php dosyasına şu satırı geçici olarak ekleyin:

define( 'WP_ALLOW_REPAIR', true );

Ardından tarayıcınızda siteniz.com/wp-admin/maint/repair.php adresini ziyaret edin; WordPress size “Veritabanını Onar” veya “Veritabanını Onar ve İyileştir” seçeneklerini sunar. İkinci seçenek biraz daha uzun sürer ama tabloları da optimize eder. İşlem bittikten sonra wp-config.php dosyasına eklediğiniz satırı mutlaka silin; bu araç, silinmediği sürece kimlik doğrulaması olmadan herkese açık kalır ve güvenlik riski oluşturur.

Veritabanı tablolarının bozulup bozulmadığını kontrol edin

Onarım aracı bir tabloyu düzeltemediğini bildiriyorsa, hosting panelinizdeki phpMyAdmin üzerinden manuel kontrol gerekir. phpMyAdmin’de veritabanınızı açın, tüm tabloları seçin ve “Onar Tablo” (Repair Table) işlemini çalıştırın. Bazı tablo motorlarında (özellikle InnoDB) bu işlem farklı sonuç verebilir; böyle bir durumda son bilinen sağlam yedeğe dönmek, tabloyu satır satır düzeltmeye çalışmaktan daha güvenlidir.

Tablo öneki (table prefix) uyuşmazlığı

Daha az bilinen ama gerçek bir neden de tablo önekidir. WordPress kurulumunda varsayılan öneki (wp_) değiştirdiyseniz veya site farklı bir kurulumdan taşındıysa, wp-config.php içindeki $table_prefix değişkeninin veritabanındaki gerçek tablo adlarıyla (örneğin wp_options yerine ab12_options) eşleşip eşleşmediğini kontrol edin. Uyumsuz bir önek, veritabanı bağlantısının kendisi başarılı olsa bile WordPress’in doğru tabloları bulamamasına ve aynı hatanın görünmesine yol açabilir.

Hiçbir adım işe yaramazsa: yedekten geri yükleme ve hosting desteği

Yukarıdaki adımların hepsini denediyseniz ve veritabanı bağlantısı kurulamadı hatası hâlâ sürüyorsa, sorun büyük olasılıkla sunucu tarafındadır: MySQL servisinin çökmüş olması, bir donanım arızası veya sunucu yapılandırma hatası gibi. Bu noktada en güvenli adım, hangi kontrolleri yaptığınızı ve wp-config.php’deki değerleri (parolayı paylaşmadan) hosting sağlayıcınızın teknik destek ekibiyle net biçimde paylaşmaktır; onların sunucu tarafı erişimi, sizin panelden göremeyeceğiniz ayrıntıları ortaya çıkarabilir.

Destek ekibinden de sonuç alamıyorsanız veya veritabanı geri getirilemeyecek kadar bozulduysa, son çare en yakın tarihli yedekten geri yüklemektir. Bu yüzden düzenli, sitenizin dışında bir yerde saklanan otomatik yedekleme, bu hatanın en kötü senaryosuna karşı tek gerçek güvencedir.

Veritabanı bağlantısı kurulamadı hatasını tekrar yaşamamak için

Bu hatanın büyük kısmı önlenebilir. Veritabanı parolasını hosting panelinden değiştirdiğinizde bunu aynı anda wp-config.php’ye de yansıtmayı bir alışkanlık haline getirin; site taşıma işlemlerinde DB_HOST ve tablo önekini kontrol listesine ekleyin; hosting planınızın kaynak kotasını (özellikle trafik arttığında) takip edin ve site dışında bir konumda düzenli yedek alın. Bu konuyu WordPress bakımının bütünü bağlamında ele alan WordPress beyaz ekran hatası rehberimizde benzer bir disiplin öneriyoruz; iki hata da aynı üç kaynaktan (bağlantı/erişim, sunucu kaynakları, dosya bütünlüğü) besleniyor.

wp-config.php içindeki DB_NAME, DB_USER, DB_PASSWORD ve DB_HOST sabitlerinin güncel ve resmi referansı için WordPress’in kendi wp-config.php dokümantasyonuna bakabilirsiniz. E-posta gönderimiyle ilgili farklı bir WordPress sorunuyla karşılaşıyorsanız WordPress e-posta gönderme sorunu rehberimiz konuyu ayrıca ele alıyor.

Sonraki adım

Veritabanı bağlantısı kurulamadı hatası, ürkütücü görünse de çoğu zaman wp-config.php dosyasındaki birkaç satırı doğrulamakla çözülen, dikkatli ilerlendiğinde veri kaybı riski taşımayan bir sorundur. Sorun sunucu tarafında tekrarlıyorsa veya kurulumunuz büyüdükçe bu tür kesintilere karşı daha dayanıklı bir altyapı istiyorsanız, grup şirketimiz Web Tasarım Ofisi WordPress kurulumu, veritabanı bakımı ve teknik sorun giderme konusunda destek veriyor.

Sitenizin teknik altyapısını veya özel yazılım ihtiyaçlarınızı birlikte değerlendirmek için özel yazılım hizmetimizi inceleyebilir ya da bizimle iletişime geçebilirsiniz.