Error establishing a database connection

Bu hata neden oluşur?

Nedenler, sahada karşılaştığımız sıklığa göre sıralıdır.

1. 01

   wp-config.php'de yanlış veritabanı bilgileri

   Çok sık

   DB_NAME, DB_USER, DB_PASSWORD ya da DB_HOST değerlerinden biri yanlış yazılmış ya da hosting tarafında değiştirilmiş olabilir.

2. 02

   Veritabanı sunucusu çalışmıyor ya da aşırı yüklenmiş

   Sık

   Paylaşımlı sunucularda MySQL servisi geçici olarak durabilir ya da eş zamanlı bağlantı limiti dolabilir.

3. 03

   Bozuk veritabanı tabloları

   Sık

   Ani kapanma, yarım kalan güncelleme ya da disk sorunu tabloları bozabilir; WordPress bu durumda da bağlantı hatası gösterebilir.

4. 04

   Bozuk ya da değiştirilmiş çekirdek dosyaları

   Ara sıra

   wp-config.php ya da wp-includes/wp-db.php dosyası elle düzenlenmiş, eksik yüklenmiş ya da bir saldırı sonrası değiştirilmiş olabilir.

5. 05

   Hosting tarafında IP/host kısıtlaması

   Nadiren

   Bazı kurulumlarda veritabanı sunucusu farklı bir sunucuda çalışır ve yeni sunucu IP'sinin erişimi tanımlı değildir.

Adım adım çözüm

1. 1

   /wp-admin/ adresini kontrol edin

   Siteniz hata verirken /wp-admin/ adresini açın. Burada "One or more database tables are unavailable" gibi daha ayrıntılı bir mesaj görürseniz sorun büyük ihtimalle bozuk tablolardadır, kimlik bilgisi sorunu değildir.

2. 2

   wp-config.php dosyasındaki veritabanı bilgilerini doğrulayın

   Sunucudaki wp-config.php dosyasını açın ve DB_NAME, DB_USER, DB_PASSWORD, DB_HOST satırlarını hosting kontrol panelindeki (ör. cPanel > MySQL Databases) gerçek değerlerle karşılaştırın. Tek bir karakter farkı bile hataya yol açar.

   php

   define( 'DB_NAME', 'veritabani_adi' );
   define( 'DB_USER', 'veritabani_kullanicisi' );
   define( 'DB_PASSWORD', 'veritabani_sifresi' );
   define( 'DB_HOST', 'localhost' );
   

3. 3

   DB_HOST değerini test edin

   Bazı hosting sağlayıcılarında (ör. GoDaddy, bazı paylaşımlı sunucular) veritabanı "localhost" yerine ayrı bir sunucu adresinde çalışır. (hosting sağlayıcınızın veritabanı sunucu adresini destek dokümanından teyit edin) Doğru host değerini panelden ya da destek ekibinden alın.

4. 4

   Komut satırından veritabanına bağlanmayı deneyin

   Sunucuya SSH erişiminiz varsa aynı bilgilerle doğrudan MySQL'e bağlanmayı deneyin. Bağlantı başarısız olursa sorun WordPress'te değil, veritabanı sunucusunda ya da kimlik bilgilerindedir.

   bash

   mysql -u veritabani_kullanicisi -p -h localhost veritabani_adi
   

5. 5

   WP-CLI ile veritabanı sağlığını kontrol edin

   WP-CLI kuruluysa aşağıdaki komutla bağlantıyı ve tabloları hızlıca kontrol edebilirsiniz. Komut çalışmazsa bağlantı sorunu, tablo hatası verirse veritabanı onarımı gerekir.

   bash

   wp db check
   

6. 6

   Veritabanını onarım moduna alın

   Önce tam yedek alın. Ardından wp-config.php dosyasına aşağıdaki satırı ekleyip siteyi.com/wp-admin/maint/repair.php adresini açın; WordPress arayüzden "Repair Database" seçeneğini sunar. İşlem bittikten sonra bu satırı silin.

   php

   define( 'WP_ALLOW_REPAIR', true );
   

7. 7

   Sunucu kaynaklarını ve bağlantı limitini kontrol edin

   Hosting kontrol panelinden ya da destek ekibinden MySQL servisinin çalışıp çalışmadığını, max_connections değerinin dolup dolmadığını sorun. [bu ayar sunucuya göre değişir, panel adı ve limit hostinge göre farklıdır]

8. 8

   Eklenti/tema çakışmasını test edin

   Önce yedek alın. Eklentileri toplu devre dışı bırakmak için FTP/SSH üzerinden plugins klasörünü geçici olarak yeniden adlandırın; site açılırsa eklentileri tek tek geri getirip sorunluyu bulun.

   bash

   mv wp-content/plugins wp-content/plugins-disabled
   

9. 9

   Hosting destek ekibiyle iletişime geçin

   Yukarıdaki adımlar sonuç vermezse sorun sunucu tarafında olabilir. Hata zaman damgasını ve yaptığınız kontrolleri destek ekibiyle paylaşarak süreci hızlandırabilirsiniz.

Hangi sürümlerde görülüyor?

Çözüldüğünü nasıl anlarsınız?

• Site ana sayfası ve /wp-admin/ girişi hatasız açılıyor.
• wp db check komutu hata döndürmüyor.
• Hosting panelinde MySQL servisi "çalışıyor" durumunda görünüyor.
• Eklenti klasörü eski adına geri döndürüldü ve site çalışmaya devam ediyor.

Ne zaman uzmana başvurmalı?

Veritabanı kimlik bilgileri doğruysa ve sunucu çalışıyorsa ama hata sürüyorsa, sorun genelde bozuk tablolarda ya da dosya düzeyinde bir müdahalededir. Hata Ayıklama ve Onarım hizmetimizde veritabanı loglarını, sunucu kayıtlarını ve dosya bütünlüğünü birlikte inceleyip kök nedeni bularak kalıcı çözüm sunuyoruz.

İlgili sayfalar: Hata Ayıklama ve Onarım · Acil Müdahale · Bu sitede kritik bir hata oluştu · WordPress hata çözümleri

Sık sorulanlar

Kaynaklar

• Editing wp-config.php – WordPress Developer Resources
• Debugging in WordPress
• WordPress.org Support: Error establishing a database connection