WordPress Veritabanı Bağlantı Hatası ve Çözümü
WordPress veritabanı bağlantısı kurulurken hata mı veriyor? wp-config.php ayarları, giriş testi, MariaDB, tablo onarımı ve taşıma sonrası hatalar.

İçindekiler
- Hata ne anlama geliyor?
- wp-config.php içindeki bilgileri kontrol edin
- Veritabanı girişini test edin
- Veritabanı sunucusu çalışıyor mu?
- Bozuk tabloları onarın
- DB_HOST: localhost, 127.0.0.1 ya da soket
- Taşımadan sonra
- Çok fazla bağlantı
- Site hacklenmiş olabilir mi?
- Günlüklerde nereye bakmalı?
- Nodesty'de WordPress veritabanları
Veritabanı bağlantısı kurulurken hata oluştu mesajı WordPress'in en ürkütücü hatalarından biridir; çünkü sitenin tamamı tek bir beyaz sayfanın arkasında kaybolur. İyi haber şu ki içerik genellikle yerinde durur. WordPress yalnızca MySQL ya da MariaDB veritabanına ulaşamıyordur ve sebep hemen her zaman birkaç olasılıktan biridir.
Bu rehberde mesajın ne anlama geldiğini, wp-config.php içindeki bilgilerin kontrolünü, veritabanı girişini test etmeyi, durmuş bir veritabanı sunucusunu, bozuk tabloların onarımını, taşıma sonrası bozulan ayarları, bağlantı sınırlarını ve günlüklerde nereye bakmanız gerektiğini anlatıyoruz.
Hata ne anlama geliyor?
WordPress medya dosyaları dışındaki her şeyi veritabanında tutar: yazılar, sayfalar, kullanıcılar, ayarlar ve eklenti verileri. Her sayfa açılışında PHP, wp-config.php içindeki bilgilerle veritabanına bağlanır. Bu bağlantı kurulamazsa WordPress durur ve bu mesajı gösterir. İngilizce kurulu sitelerde aynı hata "Error establishing a database connection" olarak görünür.
Sık görülen sebepler:
| Sebep | Tipik belirti |
|---|---|
| wp-config.php'de yanlış bilgiler | Taşımadan ya da şifre değişikliğinden hemen sonra çıkan hata |
| Veritabanı sunucusu durmuş | Sunucudaki tüm siteler hata veriyor |
| Bozuk tablolar | wp-admin tabloların kullanılamadığını ve onarım gerektiğini der |
| Bağlantı ya da bellek sınırları | Hata gelip gidiyor, çoğunlukla yoğun saatlerde |
| Hacklenmiş site | Kimse bir şey değiştirmeden ortaya çıkan hata |
wp-config.php içindeki bilgileri kontrol edin
Sitenizin kök klasöründeki (genellikle public_html) wp-config.php dosyasını kontrol panelinin dosya yöneticisiyle ya da SFTP ile açın ve şu satırları bulun:
define( 'DB_NAME', 'cpuser_wp123' );
define( 'DB_USER', 'cpuser_wpuser' );
define( 'DB_PASSWORD', 'guclu-sifre' );
define( 'DB_HOST', 'localhost' );
Her değeri gerçekten var olan veritabanıyla karşılaştırın. cPanel ve DirectAdmin'de veritabanı ve kullanıcı adları hesap adınız ve bir alt çizgiyle başlar, örneğin cpuser_wp123; taşımadan sonra bu öneki unutmak sık yapılan bir hatadır. Şifrenin başında ya da sonunda fazladan boşluk olmadığını, şifredeki tek tırnağın da \' şeklinde yazıldığını kontrol edin.
Veritabanı girişini test edin
Bilgilerin doğru olup olmadığını tahmin etmeyin, test edin. SSH üzerinden, wp-config.php içindeki bilgilerle:
mysql -u cpuser_wpuser -p -h localhost cpuser_wp123
MariaDB [cpuser_wp123]> istemini görüyorsanız bilgiler doğrudur. Access denied for user kullanıcı adının ya da şifrenin, Unknown database veritabanı adının yanlış olduğunu gösterir. Can't connect to local server through socket gibi bir hata (MySQL'de ifadesi biraz farklıdır) ise veritabanı sunucusunun çalışmadığını ya da başka bir yerden dinlediğini anlatır.
SSH erişiminiz yoksa paneli kullanın: cPanel'de MySQL Databases (DirectAdmin'de MySQL Management) bölümünde veritabanının var olduğunu, kullanıcının tüm yetkilerle veritabanına atandığını kontrol edin ve gerekirse kullanıcıya yeni bir şifre verin. Ardından aynı şifreyi wp-config.php dosyasına yazın. Tabloları görmek için veritabanını phpMyAdmin ile açın.
Veritabanı sunucusu çalışıyor mu?
Sunucudaki tüm siteler aynı anda hata veriyorsa büyük ihtimalle veritabanı sunucusunun kendisi durmuştur. Paylaşımlı hostingde sağlayıcınıza başvurun; kendi VDS'nizde şöyle kontrol edin:
sudo systemctl status mariadb
sudo journalctl -u mariadb --since "1 hour ago"
MariaDB yerine MySQL kullanıyorsanız servisin adı Ubuntu/Debian'da mysql, AlmaLinux'ta mysqld olur. Yeniden başlatmak için:
sudo systemctl restart mariadb
Servis başlamıyor ya da sürekli duruyorsa tekrar tekrar başlatmak yerine sebebini arayın. En sık iki sebep:
- Disk dolmuştur. MariaDB veri ve günlük dosyalarını yazamaz ve durur.
df -hile kontrol edin; nasıl yer açacağınızı Linux sunucuda disk doldu rehberimizde anlattık. - Bellek tükenmiştir. RAM bittiğinde çekirdeğin bellek yetersizliği mekanizması (OOM killer) çoğu zaman en büyük süreci, yani genellikle veritabanını sonlandırır. Bunu çekirdek günlüğünde görebilirsiniz:
sudo journalctl -k | grep -i "out of memory"
Bellek düzenli olarak tükeniyorsa innodb_buffer_pool_size değerini düşürün, swap ekleyin ya da daha fazla RAM'i olan bir pakete geçin. Veritabanı sunucusunun kurulumunu ve ayarlarını MySQL ve MariaDB kurulumu rehberimizde ele aldık.
Bozuk tabloları onarın
Giriş çalışıyor, sunucu da açıksa ama WordPress hâlâ hata veriyorsa ya da /wp-admin "One or more database tables are unavailable" (bir veya daha fazla veritabanı tablosu kullanılamıyor) diyorsa bazı tablolar bozulmuştur. Önce veritabanının yedeğini alın, ardından şu satırı wp-config.php dosyasında /* That's all, stop editing! */ satırının üstüne ekleyin:
define( 'WP_ALLOW_REPAIR', true );
Sonra https://alanadiniz.com/wp-admin/maint/repair.php adresini açın ve Veritabanını onar seçeneğine tıklayın. Bu sayfa giriş yapmadan da açılır; bu yüzden onarım biter bitmez satırı wp-config.php dosyasından kaldırın.
SSH erişiminiz varsa aynı işi mysqlcheck ya da WP-CLI ile yapabilirsiniz:
mysqlcheck -u cpuser_wpuser -p --auto-repair cpuser_wp123
wp db repair
DB_HOST: localhost, 127.0.0.1 ya da soket
DB_HOST hemen her hosting paketinde localhost'tur. Fark, kendi sunucunuzda önem kazanır:
localhost: PHP yerel Unix soketi üzerinden bağlanır.127.0.0.1: PHP TCP ile, genellikle 3306 numaralı porttan bağlanır. Portu da ekleyebilirsiniz:127.0.0.1:3306.- Soket yolu: Soket PHP'nin beklediği yerde değilse
localhost:/run/mysqld/mysqld.sock.
localhost çalışmazsa 127.0.0.1'i deneyin, tersi de geçerli. Veritabanı başka bir sunucuda çalışıyorsa onun adresini yazın; veritabanı kullanıcısının web sunucunuzun IP adresinden bağlanmasına izin verildiğini ve güvenlik duvarının 3306 numaralı portu yalnızca oradan açtığını kontrol edin.
Taşımadan sonra
Bu hataların çoğu bir siteyi taşıdıktan hemen sonra ortaya çıkar. Şu noktaları kontrol edin:
- Yeni bilgiler: Yeni hostingdeki veritabanı adı, kullanıcı ve şifre neredeyse hiçbir zaman eskisiyle aynı değildir.
wp-config.phpiçindeki dört satırın hepsini güncelleyin. - Veritabanı içe aktarıldı mı? Veritabanını phpMyAdmin ile açın ve tabloların orada olduğundan emin olun.
- Tablo öneki:
wp-config.phpiçindeki$table_prefix, içe aktarılan tabloların önekiyle (örneğinwp_ya dawpab_) aynı olmalıdır. Aynı değilse WordPress siteniz yerine genellikle kurulum ekranını gösterir. - siteurl ve home: Alan adı değiştiyse
wp_optionstablosundaki eski adres ziyaretçileri eski siteye gönderir. Geçici olarakwp-config.phpiçinden düzeltebilirsiniz:
define( 'WP_HOME', 'https://alanadiniz.com' );
define( 'WP_SITEURL', 'https://alanadiniz.com' );
Sürecin tamamını adım adım web sitesi taşıma rehberimizde anlattık.
Çok fazla bağlantı
Hata gelip gidiyorsa veritabanı yeni bağlantıları reddediyor olabilir. Bu durumda günlüklerde Too many connections (sunucu genelindeki max_connections sınırı) ya da has exceeded the 'max_user_connections' resource (paylaşımlı hostingde sık görülen kullanıcı başına sınır) görürsünüz. Kendi sunucunuzda sınırı ve açık bağlantıları şöyle kontrol edebilirsiniz:
SHOW VARIABLES LIKE 'max_connections';
SHOW FULL PROCESSLIST;
Sınırı yükseltmek yalnızca belirtiyi tedavi eder. Arkasında çoğunlukla yavaş sorgular, çok bağlantı açan bir eklenti ya da önbelleksiz karşılanan bot trafiği vardır. LiteSpeed Cache gibi bir sayfa önbelleği veritabanı sorgularının sayısını büyük ölçüde azaltır.
Site hacklenmiş olabilir mi?
Kimse bir şey değiştirmediği halde hata birdenbire çıktıysa bir saldırı ihtimalini düşünün. Zararlı yazılımlar bazen wp-config.php dosyasını değiştirir, panel erişimi ele geçiren bir saldırgan da veritabanı şifresini değiştirebilir ya da tabloları silebilir. Dosyanın ne zaman değiştiğine bakın:
ls -l --time-style=long-iso wp-config.php
Tarih sizin yaptığınız bir değişikliğe denk gelmiyorsa bilgileri düzeltmeden önce site hacklendi, ne yapmalı? rehberimizi izleyin.
Günlüklerde nereye bakmalı?
- WordPress:
wp-config.phpiçindedefine( 'WP_DEBUG', true );vedefine( 'WP_DEBUG_LOG', true );ayarlarını yaparsanız hatalarwp-content/debug.logdosyasına yazılır. İşiniz bitince yeniden kapatın. - PHP: cPanel site klasöründeki
error_logdosyasını ve Errors sayfasını gösterir; DirectAdmin alan adının hata günlüğünü panelde sunar. - MariaDB/MySQL: Yapılandırmaya bağlı olarak
journalctl -u mariadb, Ubuntu/Debian'da/var/log/mysql/error.log, AlmaLinux'ta/var/log/mariadb/mariadb.log.
Tarayıcı bu mesaj yerine 500 hatası gösteriyorsa sorun büyük ihtimalle veritabanında değil PHP'dedir; farkı HTTP hata kodları rehberimizde anlattık.
Nodesty'de WordPress veritabanları
Nodesty web hosting paketleri, WordPress sitelerini AMD Ryzen 9 7900 işlemcili sunucularda LiteSpeed web sunucusu ve NVMe diskle çalıştırır. Veritabanlarını ve kullanıcıları cPanel ya da DirectAdmin ve phpMyAdmin ile yönetir, JetBackup ile bir veritabanını panelden geri yükleyebilirsiniz. MariaDB'yi kendiniz yönetmek isterseniz AMD Ryzen 9 9950X VDS paketlerimiz tam root erişimi ve 7 gün saklanan ücretsiz günlük yedekler sunar.
Sıkça Sorulan Sorular
Veritabanı bağlantısı kurulurken hata oluştu mesajı ne anlama gelir?
WordPress yazıları, sayfaları, kullanıcıları ve ayarları bir MySQL ya da MariaDB veritabanında tutar. Bu mesaj, PHP'nin bu veritabanına bağlanamadığını, dolayısıyla WordPress'in gösterecek bir şeyi olmadığını anlatır. Sebep neredeyse her zaman wp-config.php'deki yanlış bilgiler, durmuş bir veritabanı sunucusu ya da bir sınıra takılan veritabanıdır.
Yazılarım ve sayfalarım silindi mi?
Genellikle hayır. Hata, verilerin gittiğini değil, WordPress'in veritabanına ulaşamadığını gösterir. Bağlantı bilgileri düzeltildiğinde ya da veritabanı sunucusu yeniden çalıştığında site eskisi gibi açılır. Yine de tablo onarmadan ya da bir şey değiştirmeden önce veritabanının yedeğini alın.
Site hata veriyor ama wp-admin açılıyor, bu nasıl olur?
wp-admin bir veya daha fazla veritabanı tablosunun kullanılamadığını söylüyorsa bazı tablolar bozulmuştur. wp-config.php'de WP_ALLOW_REPAIR'i etkinleştirin, /wp-admin/maint/repair.php adresinden onarımı çalıştırın ve işiniz bitince satırı yeniden kaldırın.
DB_HOST localhost mu olmalı, 127.0.0.1 mi?
Çoğu hosting paketinde localhost'tur. localhost yerel Unix soketi üzerinden, 127.0.0.1 ise 3306 numaralı porttan TCP ile bağlanır. Biri çalışmazsa diğerini deneyin; veritabanı başka bir sunucudaysa o sunucunun adresini yazın ve kullanıcının web sunucunuzdan bağlanmasına izin verildiğinden emin olun.
Hata neden sadece yoğun saatlerde çıkıyor?
Veritabanının bağlantıları ya da belleği tükeniyor olabilir. Çok fazla bağlantı, veritabanı kullanıcısındaki max_user_connections sınırı ya da MariaDB'nin bellek yetersizliği nedeniyle sonlandırılması yük altında hataya yol açar. Önbellek, daha az ağır eklenti ya da daha fazla kaynak bunu kalıcı olarak çözer.
Hacklenmiş bir site bu hataya yol açabilir mi?
Evet. Zararlı yazılımlar bazen wp-config.php'yi değiştirir, saldırgan da veritabanı kullanıcısının şifresini değiştirebilir ya da tabloları silebilir. Hiçbir şeyi değiştirmediğiniz halde bilgiler birden çalışmaz olduysa wp-config.php'nin en son ne zaman değiştirildiğine bakın ve siteyi zararlı yazılıma karşı taratın.
Yazar hakkında
Nodesty Ekibi · Altyapı ve Destek
Nodesty ekibi sunucularımızı, ağımızı ve DDoS korumamızı her gün işletir ve müşteri destek taleplerini 7/24 yanıtlar. Bu rehberler o deneyimden yazılır.
İlgili yazılar

WordPress Dosya Yükleme Limiti Nasıl Artırılır?
WordPress dosya yükleme limiti nasıl artırılır? upload_max_filesize hatasını cPanel, DirectAdmin, .user.ini, .htaccess ya da kendi VDS'inizde çözün.

502 Bad Gateway Hatası: Sebepleri ve Çözümü
502 Bad Gateway hatası mı alıyorsunuz? Nginx hata günlüğünü okuma, PHP-FPM ya da uygulamayı başlatma, port ve soket, pm.max_children, Cloudflare kontrolü.

WordPress Şifre Sıfırlama: Yönetici Hesabına Yeniden Girin
WordPress'e giremiyor musunuz? Yönetici şifresini şifremi unuttum bağlantısı, WP-CLI, phpMyAdmin ya da MySQL ile sıfırlayın veya yeni yönetici oluşturun.