Cara Mengatasi Error “Establishing Database Connection” (Panduan Lengkap untuk Pemula)

Error “Error Establishing a Database Connection” adalah salah satu masalah paling umum (dan bikin panik) pada WordPress. Biasanya layar website mendadak putih lalu muncul pesan ini, sehingga halaman tidak bisa diakses sama sekali. Kabar baiknya, error ini hampir selalu bisa diperbaiki tanpa harus instal ulang, asalkan kamu tahu penyebabnya dan langkah penanganannya.

Di artikel ini, kamu akan belajar penyebab paling sering, cara cek yang benar, dan langkah perbaikan yang aman—khususnya untuk WordPress di hosting cPanel maupun server umum.

Apa Arti Error Establishing Database Connection?

Pesan ini berarti WordPress gagal terhubung ke database. Database adalah tempat semua data website disimpan: postingan, halaman, user, konfigurasi plugin, dan lain-lain. Kalau WordPress tidak bisa “ngobrol” dengan database, website tidak akan bisa memuat konten apa pun.

Secara teknis, error terjadi ketika WordPress mencoba koneksi ke MySQL/MariaDB tetapi gagal karena kredensial salah, server database down, database korup, atau resource hosting habis.

Penyebab Umum Error Ini

Beberapa penyebab yang paling sering:

• Username/password database salah (di file wp-config.php)

• Database server down (MySQL/MariaDB bermasalah atau restart)

• Database korup (tabel rusak karena crash, plugin, atau limit resource)

• Hosting kehabisan resource (CPU/RAM/entry process limit)

• Masalah setelah migrasi (pindah domain/hosting tapi config belum sesuai)

• File/permission bermasalah (lebih jarang, tapi bisa terjadi)

Langkah Cepat: Pastikan Masalahnya di Database, Bukan Internet/Cache

Sebelum masuk teknis, lakukan cek sederhana:

1. Coba buka halaman admin: domain.com/wp-admin

2. Kalau admin juga menampilkan error yang sama, kemungkinan besar memang koneksi DB.

3. Kalau hanya halaman depan error tapi admin bisa dibuka, bisa jadi plugin/cache atau tema memicu error—tetapi kasus ini lebih jarang untuk pesan database.

Cara 1: Cek dan Perbaiki Kredensial Database di wp-config.php

Ini penyebab paling umum.

1. Masuk ke File Manager (cPanel) atau FTP.

2. Buka file wp-config.php di root WordPress.

3. Cari bagian ini:

• DB_NAME

• DB_USER

• DB_PASSWORD

• DB_HOST

Contohnya:

• define('DB_NAME', 'nama_database');

• define('DB_USER', 'user_database');

• define('DB_PASSWORD', 'password_database');

• define('DB_HOST', 'localhost');

Lalu cocokkan dengan data database di cPanel:

• Masuk MySQL Databases

• Lihat Database Name dan Users

• Pastikan user sudah di-assign ke database dan punya ALL PRIVILEGES

Catatan penting: pada beberapa hosting, DB_HOST bukan localhost melainkan seperti 127.0.0.1 atau host khusus (misalnya mysql.domain.com). Jika kamu baru migrasi, DB_HOST sering jadi sumber masalah.

Setelah diperbaiki, simpan file dan refresh website.

Cara 2: Cek Apakah Server Database (MySQL) Sedang Down

Kalau data di wp-config.php sudah benar, bisa jadi MySQL/MariaDB di hosting sedang bermasalah.

Tanda-tanda umum:

• Website error, tapi file statis masih bisa diakses.

• Di cPanel terasa lambat atau muncul notifikasi gangguan layanan.

Yang bisa kamu lakukan:

• Cek halaman status hosting (kalau ada).

• Coba login ke phpMyAdmin dari cPanel.
  Jika phpMyAdmin juga gagal dibuka atau muncul error koneksi, besar kemungkinan server database sedang down.

Solusi terbaik pada kasus ini:

• Restart layanan MySQL (kalau kamu pakai VPS/dedicated).

• Kalau shared hosting: hubungi support hosting dan sampaikan “MySQL server kemungkinan down / database connection failed”.

Cara 3: Perbaiki Database yang Korup (Database Repair)

Kalau database korup, WordPress kadang bisa diperbaiki dengan fitur repair bawaan.

1. Edit wp-config.php, tambahkan baris ini di atas “That’s all, stop editing!”:

   • define('WP_ALLOW_REPAIR', true);

2. Akses halaman repair:

   • domain.com/wp-admin/maint/repair.php

3. Klik Repair Database (atau Repair and Optimize).

4. Setelah selesai, hapus lagi baris WP_ALLOW_REPAIR tadi dari wp-config.php demi keamanan.

Jika repair gagal, lanjut ke cara berikutnya.

Cara 4: Cek Resource Hosting (CPU/RAM/Entry Process Limit)

Website bisa error database jika server overload, terutama saat traffic tinggi atau plugin berat jalan bersamaan.

Yang bisa kamu cek:

• Di cPanel: Resource Usage (jika tersedia)

• Lihat apakah sering “faults”, “entry process limit reached”, atau “CPU throttled”.

Solusinya:

• Matikan plugin berat (sementara) dengan rename folder plugin via File Manager:
  wp-content/plugins → plugins-off

• Aktifkan plugin satu per satu setelah normal.

• Upgrade paket hosting jika memang sudah sering limit.

Cara 5: Pastikan User Database Punya Akses ke Database

Kadang DB_NAME/DB_USER benar, tapi user belum diberi akses ke database.

Di cPanel:

1. Masuk MySQL Databases

2. Di “Add User to Database”, pilih user dan database

3. Centang ALL PRIVILEGES

4. Simpan

Ini sering terjadi setelah migrasi manual atau restore backup parsial.

Cara 6: Jika Baru Migrasi, Pastikan Database dan URL Tidak Bentrok

Jika error muncul setelah pindah hosting/domain:

• Pastikan file wp-config.php sudah menggunakan DB baru.

• Pastikan database yang diimport benar-benar lengkap.

• Pastikan tidak ada prefix tabel yang berbeda (misalnya wp_ berubah) dan tidak sesuai di config.

Jika kamu memakai backup plugin, pastikan restore selesai 100% (kadang restore terputus, database jadi setengah).

Kesimpulan

Error “Establishing Database Connection” berarti WordPress tidak bisa terhubung ke database. Penyebab paling umum adalah konfigurasi database salah di wp-config.php, MySQL down, database korup, atau resource hosting habis. Urutan langkah yang paling aman adalah: cek wp-config.php, tes phpMyAdmin, lakukan database repair, lalu cek resource hosting dan privilege user database.

Kalau kamu ingin, kirim screenshot bagian DB_NAME/DB_USER/DB_HOST (tanpa password) dan info apakah kamu pakai cPanel atau VPS, nanti aku bantu arahkan langkah paling tepat tanpa tanya-tanya panjang.