WordPress veritabanı bağlantı hatası, sitenin içerik ve ayarların tutulduğu MySQL ya da MariaDB veritabanına ulaşamadığını gösterir. Ekranda genellikle ‘Veritabanı bağlantısı kurulurken hata oluştu’ mesajı görünür; hem ziyaretçi tarafı hem de yönetim paneli açılmayabilir. Telaşla dosya silmek yerine aşağıdaki sırayı izlerseniz sorunun kaynağını daha güvenli ve hızlı bulabilirsiniz.
İlk kural basit: Değişiklik yapmadan önce site dosyalarının ve veritabanının güncel yedeğini alın. Yedekleme düzeniniz yoksa WordPress yedek alma rehberi ile sağlam bir başlangıç yapabilirsiniz.
WordPress veritabanı bağlantı hatası neden olur?
WordPress sayfaları, kullanıcıları, siparişleri ve eklenti ayarlarını veritabanından okur. wp-config.php içindeki bağlantı bilgileri yanlışsa veya veritabanı sunucusu cevap vermiyorsa WordPress gerekli veriyi alamaz.
En sık karşılaşılan nedenler şunlardır:
- Veritabanı adı, kullanıcı adı veya parolanın yanlış olması
DB_HOSTdeğerinin hosting firmasına uygun olmaması- MySQL/MariaDB servisinin durmuş ya da aşırı yüklenmiş olması
- Veritabanı kullanıcısının yetkilerinin kaldırılması
- Disk kotasının veya hosting kaynaklarının dolması
- Bozuk veritabanı tabloları
- Taşıma, klonlama veya alan adı değişikliği sırasında eksik yapılandırma
1. Hatanın kapsamını kontrol edin
Ana sayfayı ve /wp-admin/ adresini ayrı ayrı açın. İkisi de aynı bağlantı hatasını gösteriyorsa sunucu veya yapılandırma tarafına odaklanın. Yönetim panelinde ‘Bir veya daha fazla veritabanı tablosu kullanılamıyor’ benzeri farklı bir mesaj görürseniz tablo onarımı gerekebilir.
Site yalnızca ara sıra açılıyorsa sorun yanlış paroladan çok kaynak limiti, yoğun sorgu veya veritabanı servisindeki kesinti olabilir. Hatanın görüldüğü saatleri not etmek hosting kayıtlarını incelemeyi kolaylaştırır.
2. Hosting durumunu ve disk kotasını inceleyin
Hosting kontrol panelinde MySQL servis durumu, disk kullanımı, inode limiti ve kaynak tüketimini kontrol edin. Disk tamamen dolduğunda veritabanı yeni veri yazamaz; bağlantılar da kararsız hâle gelebilir. Aynı sunucudaki diğer siteler de hata veriyorsa servis sağlayıcı kaynaklı kesinti ihtimali yükselir.
Paylaşımlı hosting kullanıyorsanız destek ekibine şu net soruyu iletin: ‘MySQL/MariaDB servisi çalışıyor mu ve hesabım bağlantı ya da kaynak limitine ulaştı mı?’ Bu bilgi, dosyalarda gereksiz değişiklik yapmanızı önler.
3. wp-config.php veritabanı bilgilerini doğrulayın
Site kök dizinindeki wp-config.php dosyasını açın. Aşağıdaki dört değeri hosting panelindeki veritabanı bilgileriyle tek tek karşılaştırın. Değerleri kimseyle paylaşmayın; ekran görüntüsü gönderirken mutlaka gizleyin.
define( 'DB_NAME', 'veritabani_adi' );
define( 'DB_USER', 'veritabani_kullanicisi' );
define( 'DB_PASSWORD', 'guclu_parola' );
define( 'DB_HOST', 'localhost' );Dosyadaki gerçek bilgileri örnek değerlerle değiştirmeyin. Özellikle parolada tek tırnak, ters eğik çizgi veya kopyalama sırasında eklenen boşluk olup olmadığını kontrol edin. Dosyayı UTF-8 olarak kaydedin ve istemeden farklı bir uzantı eklenmediğinden emin olun.
DB_HOST her zaman localhost olmayabilir
Bazı firmalar ayrı bir veritabanı sunucusu, özel port veya socket kullanır. Kontrol panelinde verilen sunucu adresi localhost değilse DB_HOST değerini firmanın belirttiği biçimde yazın. Tahmin ederek IP veya port denemek yerine hosting belgesini esas alın.
4. Veritabanı kullanıcısını ve yetkilerini kontrol edin
Kontrol panelinde veritabanı kullanıcısının doğru veritabanına bağlı olup olmadığını inceleyin. Site taşıma veya yedekten dönme işlemlerinde kullanıcı kaydı bulunsa bile yetkiler eşleşmeyebilir. Kullanıcıyı veritabanına yeniden ekleyip gerekli yetkileri tanımlamak sorunu çözebilir.
Canlı bir WooCommerce sitesinde rastgele yeni kullanıcı oluşturmayın veya eski kullanıcıyı silmeyin. Önce mevcut eşleşmeyi not edin. Parolayı değiştirirseniz aynı yeni değeri wp-config.php dosyasına da yazmanız gerekir.
5. Veritabanı sunucusuna bağlantıyı güvenli biçimde sınayın
SSH erişiminiz ve WP-CLI kurulumunuz varsa site dizininde wp db check komutunu çalıştırabilirsiniz. Komut başarılıysa bağlantı bilgileri çalışıyor demektir; tablo veya WordPress katmanındaki başka sorunlara geçebilirsiniz.
Herkese açık dizine parola içeren geçici bir PHP test dosyası yüklemek iyi bir yöntem değildir. Böyle bir dosya unutulursa veritabanı bilgileriniz dışarı sızabilir. Teknik erişiminiz yoksa bağlantı testini hosting desteğinden isteyin.
6. Gerekirse WordPress veritabanı onarımını çalıştırın
WordPress, bozuk tablolar için yerleşik bir onarım aracı sunar. Önce yedek alın, ardından aşağıdaki satırı wp-config.php dosyasında ‘Hepsi bu kadar, düzenlemeyi bırakın’ satırının üstüne geçici olarak ekleyin:
define( 'WP_ALLOW_REPAIR', true );Ardından /wp-admin/maint/repair.php adresini açıp onarım seçeneğini çalıştırın. İşlem biter bitmez eklediğiniz satırı silin. Bu sayfa oturum açmadan erişilebildiği için ayarı kalıcı bırakmak güvenli değildir.
7. Önbellek ve veritabanı drop-in dosyalarını eleyin
Nesne önbelleği veya veritabanı bağlantısını değiştiren bir eklenti kullanıyorsanız wp-content/object-cache.php ve wp-content/db.php dosyalarını kontrol edin. Bu dosyaları doğrudan silmek yerine önce yedekleyin ve geçici olarak yeniden adlandırın. Sorun düzelirse ilgili önbellek ya da veritabanı eklentisinin ayarlarını gözden geçirin.
Normal tema dosyaları çoğu bağlantı hatasının kaynağı değildir. Bu nedenle ilk adımda tema değiştirmek yerine veritabanı erişimini doğrulamak daha doğru olur. Site farklı bir sunucu hatası gösteriyorsa WordPress 500 hatası çözüm rehberi de işinize yarayabilir.
8. Site taşıma ve yedekten dönüş ayrıntılarını karşılaştırın
Hata taşıma işleminden sonra başladıysa yeni sunucudaki veritabanı adı ve kullanıcı öneki eski sunucudan farklı olabilir. İçe aktarılan tabloların gerçekten seçtiğiniz veritabanında bulunduğunu, tablo önekinin $table_prefix değeriyle eşleştiğini ve içe aktarma işleminin hatasız tamamlandığını kontrol edin.
Eski bir yedeği doğrudan canlı mağazaya döndürmek yeni siparişleri silebilir. WooCommerce kullanıyorsanız geri yükleme zamanını, son siparişleri ve müşteri kayıtlarını ayrıca doğrulayın.
9. Sorun çözüldükten sonra son kontrolleri yapın
Site açıldığında yalnızca ana sayfaya bakıp işlemi bitirmeyin. Yönetim paneli, iletişim formu, ürün sayfası, sepet ve ödeme adımlarını test edin. WooCommerce mağazalarında yeni bir deneme siparişi oluşturup e-posta ve stok hareketini doğrulamak da faydalıdır.
- Geçici onarım sabitini kaldırın.
- Açtığınız test dosyalarını silin.
- Değiştirdiğiniz parolaları güvenli bir parola yöneticisine kaydedin.
- Önbelleği temizleyip gizli sekmede tekrar test edin.
- Hatanın nedeni kaynak limiti ise izleme ve yedekleme planı oluşturun.
Sitenin tekrar aynı hataya düşmesini nasıl önlersiniz?
Düzenli otomatik yedek, yeterli disk alanı ve güvenilir hosting üç temel korumadır. Eklenti ve tema güncellemelerini önce yedek alarak yapmak, taşıma sırasında bağlantı bilgilerini kontrol listesiyle ilerletmek ve WooCommerce sipariş tablolarını izlemek de riski azaltır.
Site tekrar çalışmaya başladığında güvenlik ve mağaza operasyonlarını da ihmal etmeyin. Sahte üyelikleri azaltmak için Bolcal Anti Spam, ödeme adımında bireysel ve kurumsal fatura bilgilerini düzenlemek için WooCommerce Bireysel Kurumsal Fatura eklentisini inceleyebilirsiniz.
Benzer pratik rehberler için blog sayfasına göz atabilirsiniz. Sorun sunucu, taşıma veya özel kod tarafında devam ediyorsa iletişim sayfasından destek isteyebilir; yeni bir proje planlıyorsanız web tasarım paketlerini inceleyebilirsiniz.
WordPress veritabanı bağlantı hatası için en güvenli sıra; önce hosting ve yedek kontrolü, ardından wp-config.php bilgileri, kullanıcı yetkileri, bağlantı testi ve gerekirse tablo onarımıdır. Her adımdan sonra siteyi yeniden sınayın; aynı anda birden fazla ayarı değiştirmeyin ki gerçek nedeni net biçimde görebilin.