“Veritabanı bağlantısı kurulurken hata oluştu” uyarısı, WordPress’in sayfayı oluşturmak için ihtiyaç duyduğu MySQL veya MariaDB veritabanına ulaşamadığını gösterir. İngilizce kurulumlarda aynı durum “Error establishing a database connection” olarak görünür ve bu WordPress veritabanı hatası çıktığında site, ziyaretçiye tek satırlık bir hata sayfasından başka bir şey göstermez. Yazılar, sayfalar ve ayarlar kaybolmuş gibi görünse de çoğu durumda veriler yerinde durur; kopan şey bağlantıdır.

Bu rehberde hatanın anlamı, en sık nedenleri, hosting panelinden yapılabilecek kontroller, WordPress’in kendi onarım aracı ve taşıma sonrası ortaya çıkan özel durum, WordPress’in resmi yönetim belgelerine dayanarak sırayla ele alınır. Anlatılan adımların bir kısmı dosya ve veritabanında değişiklik içerdiği için işe başlamadan önce mevcut durumun yedeğinin alınması önerilir.

Veritabanı bağlantısı kurulurken hata oluştu: 62 saniyelik video anlatım
Video metni

Veritabanı bağlantısı kurulurken hata oluştu ne demek? WordPress veritabanına ulaşamıyor; yazılar kaybolmuş gibi görünse de veriler çoğu durumda yerinde durur, kopan şey bağlantıdır. En yaygın neden wp-config dosyasındaki yanlış bilgilerdir. Sunucu yükü, bozuk tablolar, taşıma sonrası unutulan ayarlar ve ele geçirilmiş site de bu hatayı doğurur. Önce hatanın yönetim panelinde de çıkıp çıkmadığına bakılır. Ardından hosting durumu kontrol edilir, wp-config değerleri panelle karşılaştırılır; tablo sorunu varsa onarım aracı açılır. Veritabanı adı, kullanıcı, şifre ve sunucu adresi panelle birebir aynı olmalıdır. Hesap öneki unutulursa bağlantı düşer; sunucu adresi çoğu kurulumda localhost olarak kalır. Onarım satırı iş bitince silinir, aksi halde sayfa herkese açık kalır. Yedeksiz dosya düzenlenmez, şifre paylaşılmaz; geri yüklemeden önce hatalı halin de yedeği alınır. Taşıma sonrası kontrol listesi ve hosting desteğine yazılacaklar sayfada. Takılınca WhatsApp’tan yazılabilir. Onur Freelance nokta com.

Site Açılmıyorsa Önce Hatanın Kaynağını Birlikte Bulalım

Hata ekranı çıktığında aceleyle dosya silmek ya da eklenti kaldırmak sorunu büyütebilir. Biz önce hatanın hangi katmandan geldiğini netleştirir, ardından yedek alarak müdahale ederiz. Erişim için mümkün olduğunda ayrı bir kullanıcı tanımlanır; ana şifrelerin mesajla gönderilmesi istenmez.

Veritabanı Bağlantısı Kurulurken Hata Oluştu Ne Demek?

Bu mesaj, WordPress’in wp-config.php dosyasındaki bilgilerle veritabanı sunucusuna bağlanmayı denediğini ve başaramadığını söyler. WordPress içeriğin neredeyse tamamını veritabanında tuttuğu için bağlantı kurulamadığında hiçbir sayfa oluşturulamaz.

WordPress geliştirici belgelerindeki dead_db() fonksiyonu açıklamasına göre bağlantı kurulamadığında ön yüzde genel bir hata mesajı gösterilir; yönetim panelinde ve kurulum sırasında ise daha ayrıntılı veritabanı hatası yazdırılabilir. wp-content klasöründe db-error.php adlı bir dosya varsa WordPress standart mesaj yerine bu özel sayfayı yükler. Bazı sitelerde hatanın farklı bir tasarımla görünmesinin nedeni çoğu zaman bu dosyadır.

  • Gösterdiği: WordPress ile veritabanı arasındaki bağlantının kurulamadığı.
  • Göstermediği: Verilerin silindiği; çoğu durumda tablolar sunucuda durmaya devam eder.
  • Ziyaretçiyle ilgisi: Sorun tarayıcıda veya internet bağlantısında değil, sunucu ve ayar tarafındadır.
  • Tek başına söylemediği: Hangi bilginin yanlış olduğu; bunun için adım adım teşhis gerekir.

WordPress Veritabanı Hatasının En Sık Nedenleri

WordPress’in yaygın hatalar belgesi nedenleri üç ana başlıkta toplar: wp-config.php dosyasındaki yanlış bilgiler, hosting kaynaklı sorunlar ve ele geçirilmiş site. Sahada bunlara bozuk tablolar ve taşıma sırasında unutulan ayarlar da eklenir.

wp-config.php’deki veritabanı bilgileri yanlış

Belgeye göre en yaygın neden budur. DB_NAME (veritabanı adı), DB_USER (kullanıcı), DB_PASSWORD (şifre) ve DB_HOST (sunucu adresi) değerlerinden biri hosting panelindeki gerçek değerle eşleşmezse bağlantı reddedilir. Panelden veritabanı şifresi değiştirilip yeni şifre dosyaya işlenmediğinde de aynı tablo ortaya çıkar.

MySQL sunucusu kapalı veya aşırı yük altında

Belge, veritabanı kotasının dolup veritabanının kapatılmasını ve sunucunun hizmet dışı kalmasını hosting tarafındaki olası nedenler arasında sayar. Ani trafik artışı ya da paylaşımlı sunucudaki yoğunluk da bağlantıların yanıtsız kalmasına yol açabilir; hata gün içinde gelip gidiyorsa bu ihtimal güçlenir.

Bozuk veritabanı tabloları

Bağlantı kurulsa bile tablolar okunamıyorsa WordPress çalışamaz. Ani kapanma, disk sorunu ya da yarıda kalan bir işlem tabloları bozabilir; bu durumda yönetim panelinde onarım öneren bir uyarı görülür.

Hosting değişikliği ve taşıma

Site yeni sunucuya taşındığında veritabanı adı, kullanıcısı veya sunucu adresi değişebilir. wp-config.php eski bilgilerle kalırsa site yeni sunucuda bağlantı kuramaz.

Saldırı veya izinsiz dosya değişikliği

Resmi belge ele geçirilmiş siteyi de nedenler arasında sayar. wp-config.php dosyasının kimse dokunmadığı halde değişmesi, tanınmayan dosyalar veya yönetici hesapları bir saldırıya işaret edebilir. Bu durumda yalnız bağlantı bilgisini düzeltmek yetmez; şifreler değiştirilmeli ve açık kapatılmalıdır, aksi halde site aynı duruma yeniden düşebilir. Temizlik ve güvenlik adımları hacklenmiş WordPress sitesini kurtarma hizmetinin konusudur.

Hata Yalnız Sitede mi, Yönetim Panelinde de mi?

İlk teşhis adımı, aynı hatanın /wp-admin/ adresinde de çıkıp çıkmadığına bakmaktır; bu tek gözlem olasılıkları ikiye ayırır. Yönetim panelinde de aynı ya da daha ayrıntılı bir bağlantı hatası görünüyorsa sorun büyük olasılıkla bağlantı bilgilerinde veya veritabanı sunucusundadır.

Panelde bir veya daha fazla veritabanı tablosunun kullanılamadığını ve veritabanının onarılması gerekebileceğini söyleyen bir uyarı çıkıyorsa durum farklıdır. WordPress kaynak kodundaki is_blog_installed() fonksiyonu bu mesajı, tablolar mevcut olduğu halde ayarlar tablosuna erişilemediğinde gösterir ve onarım sayfasına bağlantı verir. Bağlantı çalışıyor, tablolar sorunlu demektir; WordPress’in onarım aracı bu durum için anlamlıdır.

Hata bir görünüp bir kayboluyorsa ve son günlerde hiçbir bilgi değişmediyse sunucu yükü öne çıkar. Bu ayrım yapılmadan wp-config.php dosyasıyla oynamak, çalışan bir ayarı bozma riski taşır.

Sayfa İçeriği

Veritabanı bağlantısı kurulurken hata oluştu: veritabanı ile sunucu arasındaki kopmuş kablo, uyarı işareti ve yapılandırma dosyasını gösteren illüstrasyon

Hosting Tarafında Sorun Var mı? Durum Sayfası ve Panel Kontrolü

Veritabanı bağlantısı kurulurken hata oluştu uyarısı görüldüğünde ayar dosyasına dokunmadan önce hosting firmasının durum sayfasına ve panel duyurularına bakılır; planlı bakım veya veritabanı sunucusu arızası varsa yapılacak iş beklemek ve destek kaydı açmaktır. Aynı hosting hesabındaki başka siteler de aynı hatayı veriyorsa sorun tek bir sitenin ayarında değil, sunucudadır.

Panelde birkaç dakikada yapılabilecek kontroller şunlardır:

  • Durum sayfasında veya panelde aktif bir arıza ya da bakım duyurusu olup olmadığı
  • phpMyAdmin benzeri veritabanı aracının açılıp açılmadığı ve tabloların listelenip listelenmediği
  • Disk ve veritabanı kotası kullanımı
  • Kaynak kullanımı grafiklerinde işlemci, bellek veya eşzamanlı işlem sınırına takılma

phpMyAdmin açılıyor ve tablolar listeleniyorsa veritabanı sunucusu çalışıyordur; dikkat bağlantı bilgilerine kayar. Kaynak sınırına sık takılan sitelerde sunucu seçiminin hıza ve aramadaki görünürlüğe etkisi web hosting seçimi rehberinde ayrıca anlatılır.

wp-config Veritabanı Ayarları Nasıl Kontrol Edilir?

wp-config veritabanı ayarları, sitenin kök dizinindeki wp-config.php dosyasında yer alan dört değerin hosting panelindeki veritabanı bilgileriyle karakter karakter karşılaştırılmasıyla kontrol edilir. Dosyaya panelin dosya yöneticisinden veya FTP ile ulaşılır; WordPress belgeleri de ilk adım olarak dosyanın FTP ile açılıp bu bilgilerin doğrulanmasını önerir.

SabitAnlamıHosting panelindeki karşılığı
DB_NAMEVeritabanı adıVeritabanları listesindeki tam ad, varsa hesap öneki dahil
DB_USERVeritabanı kullanıcısıO veritabanına yetkilendirilmiş kullanıcı adı
DB_PASSWORDKullanıcının şifresiÇoğu panelde görüntülenmez, gerekirse yeniden belirlenir
DB_HOSTVeritabanı sunucusunun adresiÇoğunlukla localhost; hosting farklı bir adres veya port verebilir

WordPress’in wp-config.php belgesine göre DB_HOST çoğu kurulumda varsayılan localhost değeriyle kalır ve büyük olasılıkla değiştirilmesi gerekmez. Farklı port kullanan sunucularda adresin sonuna port eklenir, örneğin localhost:3307. Birçok panel veritabanı ve kullanıcı adlarının başına hesap adını önek olarak ekler; öneksiz yazılan ad bağlantıyı düşürür.

Şifre panelde görüntülenemiyorsa kullanıcının şifresi panelden yenilenir ve aynı değer wp-config.php’ye yazılır. Kullanıcının ilgili veritabanına gerekli yetkilerle atanmış olduğu da aynı ekrandan doğrulanır. Dosya kaydedilmeden önce bir kopyası alınır; eksik bir tırnak veya noktalı virgül sitenin tamamen boş ekrana düşmesine yol açabilir.

Veritabanı şifresi kimseyle paylaşılmaz

wp-config.php dosyası veritabanı şifresini açık metin olarak içerir. Dosyanın ekran görüntüsü forumlara, sosyal medya gruplarına veya mesajlaşma uygulamalarına gönderilmez; yardım istenecekse şifre satırı kapatılır. Destek veren biri erişim isterse ana hesap şifresi yerine geçici bir kullanıcı tanımlanır, iş bitince bu kullanıcı silinir ve veritabanı şifresi değiştirilir.

WP_ALLOW_REPAIR ile Veritabanı Onarımı Nasıl Yapılır?

Bozuk tablo şüphesinde WordPress’in yerleşik onarım aracı, wp-config.php dosyasına define( 'WP_ALLOW_REPAIR', true ); satırı eklenerek açılır ve sitenin /wp-admin/maint/repair.php adresinde çalışır. Araç tablolar için onarım ve isteğe bağlı optimizasyon seçenekleri sunar.

  1. Dosyaların ve veritabanının mevcut halinin yedeği alınır.
  2. wp-config.php açılır, satır dosyadaki “düzenlemeyi burada bırakın” anlamındaki yorum satırından önce eklenir.
  3. Tarayıcıda alanadi.com/wp-admin/maint/repair.php adresi açılır.
  4. Onarım başlatılır ve sonuç ekranındaki tablo listesi kontrol edilir.
  5. Eklenen satır wp-config.php’den hemen silinir, ardından site ve yönetim paneli test edilir.

Son adım atlanmamalıdır. WordPress’in wp-config düzenleme belgesine göre bu ayar açıkken onarım sayfasına erişmek için oturum açmak gerekmez, çünkü veritabanı bozukken giriş de yapılamaz. Belge, ayarın yalnız gerektiğinde açılmasını ve sorun çözülünce kapatılmasını önerir; unutulan satır, sayfanın herkese açık kalması demektir.

Onarım aracı yanlış kullanıcı adı veya şifreden kaynaklanan bağlantı sorununu düzeltmez; yalnız tablo sorunlarına yöneliktir. Yönetim panelinde onarım uyarısı yoksa bu adım teşhisi ilerletmez.

Hosting Desteğine Ne Zaman ve Nasıl Başvurulur?

Panel bilgileri wp-config.php ile birebir aynıysa, phpMyAdmin açılmıyorsa veya kaynak sınırları dolmuşsa çözüm hosting desteğindedir; veritabanı sunucusunu yeniden başlatmak ya da kotayı açmak site sahibinin elinde değildir. Destek kaydı ne kadar net olursa yanıt o kadar hızlı gelir. Kayda şu bilgiler yazılır:

  • Alan adı ve hatanın ilk görüldüğü saat
  • Hatanın ön yüzde mi, yönetim panelinde mi, yoksa ikisinde de mi göründüğü
  • Son yapılan değişiklikler: güncelleme, taşıma, şifre değişikliği
  • Aynı hesaptaki diğer sitelerin durumu
  • phpMyAdmin’in açılıp açılmadığı

Destek kaydına şifre yazılmaz; kimlik doğrulaması için hosting firmasının kendi paneli ve resmi destek kanalı kullanılır. Telefonda veya e-postada veritabanı şifresi isteyen biri varsa bu talebin firmanın resmi kanalından gelip gelmediği ayrıca teyit edilir.

Yedekten Geri Dönüş Ne Zaman Son Çaredir?

Bilgiler doğru, sunucu çalışıyor ve onarım sonuç vermiyorsa ya da tablolar ağır hasarlıysa son sağlam yedeğe dönmek, veritabanı bağlantısı kurulurken hata oluştu sorununda en güvenli yoldur. Geri dönüş, yedekten sonra eklenen içeriklerin ve siparişlerin kaybolması anlamına geleceği için önce son yedeğin tarihi ve kapsamı kontrol edilir.

WordPress’in yedekleme belgesi, sitenin tam olarak geri yüklenebilmesi için hem dosyaların hem veritabanının yedeğine ihtiyaç olduğunu belirtir. Belgeye göre geri yüklemede önce dosyalar, ardından veritabanı içe aktarılır ve gerekiyorsa yapılandırma bilgileri güncellenir. Hosting firmasının otomatik yedekleri varsa geri yükleme çoğu zaman panelden başlatılabilir.

Geri yüklemeden önce hatalı halin de yedeği alınır. Yanlış tarihli bir yedeğe dönüldüğü anlaşılırsa bu kopya, kaybolan içeriğin kurtarılması için tek kaynak olabilir.

Onarım mı, Geri Yükleme mi? Kararı Veriyle Verelim

Yanlış sırayla yapılan geri yükleme, kurtarılabilecek içerikleri de silebilir. Hatanın kaynağını, son yedeğin tarihini ve hosting tarafının durumunu birlikte inceliyoruz; müdahaleyi mevcut hal yedeklendikten sonra yapıyoruz. Kapsam ve süre ön görüşmede netleşir.

Taşıma Sonrası Çıkan Veritabanı Bağlantı Hatası

Site yeni hostinge taşındıktan sonra görülen veritabanı bağlantısı kurulurken hata oluştu uyarısı çoğunlukla wp-config.php dosyasının eski sunucunun bilgileriyle kalmasından kaynaklanır. WordPress’in taşıma belgesi, veritabanı adı veya kullanıcısı değiştiyse wp-config.php değerlerinin yeni bilgilerle düzeltilmesi gerektiğini yazar.

Taşıma sonrası kontrol sırası şöyledir:

  • Yeni sunucuda veritabanı oluşturuldu ve yedek içe aktarıldı mı?
  • Yeni kullanıcı bu veritabanına yetkilendirildi mi?
  • wp-config.php’deki dört değer yeni paneldeki bilgilerle aynı mı?
  • DB_HOST yeni hostingte localhost mu, yoksa firmanın verdiği ayrı bir adres mi?
  • Alan adı hâlâ eski sunucuyu gösteriyorsa ve orada veritabanı silindiyse hata eski sunucudan geliyor olabilir mi?

Aynı belge, yeni sunucuda aynı veritabanı adını kullanmanın ve aynı giriş bilgileriyle bir kullanıcı oluşturmanın işi kolaylaştıracağını belirtir. Taşıma planlanıyorsa bu kontroller WordPress site taşıma sürecinin parçası olarak baştan yapılır.

Kendi Başına Müdahale mi, Uzman Desteği mi?

Hosting durum sayfasına bakmak ve wp-config bilgilerini panelle karşılaştırmak site sahibinin yapabileceği işlerdir; dosya düzenleme, onarım, geri yükleme veya saldırı şüphesi işin içine girdiğinde uzman desteği riski azaltır. İnternetteki hızlı çözüm listeleri genellikle bütün adımları aynı anda denemeyi önerir, kontrollü teşhis ise önce sorunun hangi katmanda olduğunu bulur.

ÖlçütGelişigüzel denemeKontrollü teşhis
Başlangıç noktasıDosya düzenleme, eklenti silmeÖn yüz, panel ve hosting ayrımı
YedekÇoğu zaman atlanırHer müdahaleden önce alınır
Onarım aracıAçılır, kapatılması unutulabilirYalnız gerektiğinde açılır, iş bitince kapatılır
ŞifrelerMesajla paylaşılabilirGeçici erişim, iş sonunda şifre değişikliği
KayıtNe değiştirildiği belirsiz kalırHer adım not edilir

Veritabanı bağlantısı kurulurken hata oluştu mesajında uzman desteğinin mantıklı olduğu durumlar şunlardır: onarımdan sonra hata devam ediyorsa, saldırı belirtileri varsa, son yedek çok eskiyse ya da hiç yedek yoksa, taşıma yarıda kalmışsa veya hata kısa aralıklarla tekrarlıyorsa. Sipariş, randevu ya da form üzerinden müşteri alan sitelerde kesintinin uzaması doğrudan iş kaybı demektir.

Onur Freelance olarak WordPress sorunlarında bu sırayı izliyoruz: önce mevcut durum yedeklenir, ardından hata katman katman daraltılır ve yapılan değişiklikler site sahibiyle paylaşılır. Tek seferlik arızalar WordPress problem çözme hizmeti kapsamında ele alınır. Onur Freelance WordPress’in veya hosting firmalarının resmi destek kanalı değildir; sunucu altyapısındaki arızaları yalnız hosting firması giderebilir.

WordPress Veritabanı Hatasını Önlemek: Bakım, Yedek ve Kaynak İzleme

Veritabanı bağlantısı kurulurken hata oluştu uyarısının önüne tamamen geçmenin tek bir yolu yoktur; riski düşüren üç alışkanlık düzenli bakım, test edilmiş yedek ve kaynak izlemedir. WordPress’in yedekleme belgesi az güncellenen siteler için haftalık, sık güncellenen siteler için günlük yedek önerir ve en az 3–5 güncel yedeğin sunucu, bulut ve yerel bilgisayar gibi farklı yerlerde saklanmasını tavsiye eder.

  • Çekirdek, tema ve eklenti güncellemelerinin yedek alındıktan sonra yapılması
  • Otomatik yedeklerin ara sıra gerçekten geri yüklenebilir olup olmadığının denenmesi
  • Disk, veritabanı kotası ve kaynak kullanımının düzenli izlenmesi
  • Kullanılmayan eklenti ve temaların kaldırılması
  • Hosting, FTP ve veritabanı şifrelerinin güçlü tutulup kimseyle paylaşılmaması

Kaynak sınırına sık takılan sitelerde daha uygun bir hosting planı da kalıcı çözümün parçası olabilir. Onur Freelance’ta hosting yıllık 2.000 TL’dir ve işletme adına açılır; ayrıntılar hosting fiyatları sayfasında yer alır. WordPress bakımı ise sitenin büyüklüğüne ve kapsama göre aylık 500–2.000 TL arasında planlanır.

Aynı Hatayı Bir Daha Yaşamamak İçin Düzenli Bakım

Hata ilk kez görüldüyse yukarıdaki sıra çoğu durumda kaynağı ortaya çıkarır. Karar aşamasındaysa mevcut yedek düzeni ve hosting durumu ücretsiz ön değerlendirmede incelenir. Güncelleme, yedek ve kaynak takibinin düzenli yürütülmesi isteniyorsa yıllık WordPress bakım ve güncelleme hizmeti için WhatsApp veya telefonla ulaşılabilir.

Sıkça Sorulan Sorular

WordPress’in wp-config.php dosyasındaki bilgilerle veritabanı sunucusuna bağlanamadığı anlamına gelir. Veriler çoğu durumda yerinde durur; sorun bağlantı bilgilerinde, sunucuda veya tablolardadır.

Hayır; hata mesajı yalnız bağlantının kurulamadığını gösterir, verilerin silindiğini göstermez. Tablolar ağır hasar görmüşse veri kaybı ayrı bir konudur ve yedekten dönüş gerekebilir.

Sitenin kök dizinindeki wp-config.php dosyasında DB_NAME, DB_USER, DB_PASSWORD ve DB_HOST satırları yer alır. Bu değerler hosting panelinin veritabanı bölümündeki bilgilerle karşılaştırılır.

WordPress belgelerine göre çoğu kurulumda localhost değişmez. Hosting farklı bir sunucu adresi veya port kullanıyorsa firmanın verdiği adres, gerekiyorsa sonuna port eklenerek yazılır.

Bu ayar açıkken onarım sayfası oturum açmadan erişilebilir durumdadır. WordPress belgeleri ayarın yalnız gerektiğinde açılmasını ve sorun çözülünce kapatılmasını önerir.

En sık neden wp-config.php dosyasının eski sunucunun veritabanı adı, kullanıcısı veya şifresiyle kalmasıdır. Yeni veritabanının oluşturulduğu, yedeğin içe aktarıldığı ve kullanıcının yetkilendirildiği de kontrol edilir.

Hayır; şifre mesajla, forumda veya ekran görüntüsüyle paylaşılmaz. Erişim gerekiyorsa geçici bir kullanıcı tanımlanır, iş bitince bu kullanıcı silinir ve şifre değiştirilir.

Onur Freelance’ta WordPress bakımı sitenin büyüklüğüne ve kapsama göre aylık 500–2.000 TL arasında planlanır. Onur Freelance WordPress’in veya hosting firmalarının resmi destek kanalı değildir.

Onur Ertem - Onur Freelance Kurumsal Web Tasarım

Onur Ertem

İşletmenizi Dijitalde Güçlendirin! 🚀 Kurumsal web tasarım ve dijital pazarlama çözümleriyle markanızı büyütmeye hazır mısınız? Hemen bize ulaşın, profesyonel desteğimizle dijital dünyada öne çıkın!

Bizi Arayın

Detaylı bilgi için bizi arayın.

Sizi, Biz Arayalım!

Numaranızı paylaşın sizi, biz arayalım!

İletişim Bilgileri