Cara Mengatasi Error “Establishing a Database Connection” di WordPress

Pernah membuka website WordPress lalu muncul pesan “Error Establishing a Database Connection”? Error ini cukup sering membuat panik, terutama kalau website sedang digunakan untuk bisnis, toko online, landing page, atau blog yang menerima traffic setiap hari. Pesan tersebut menandakan bahwa WordPress tidak bisa terhubung ke database, sehingga konten website gagal ditampilkan.

Di WordPress, database adalah tempat menyimpan data penting seperti artikel, halaman, pengaturan website, data user, komentar, produk WooCommerce, hingga konfigurasi plugin. Jadi, ketika koneksi database bermasalah, website tidak bisa mengambil data yang dibutuhkan untuk menampilkan halaman.

Kabar baiknya, error ini biasanya bisa diperbaiki jika kita mengecek penyebabnya secara bertahap. Di artikel ini, kita akan membahas penyebab umum Error “Establishing a Database Connection” di WordPress dan cara mengatasinya dengan bahasa yang mudah dipahami pemula.

Apa Itu Error “Establishing a Database Connection”?

Error “Establishing a Database Connection” adalah kondisi ketika WordPress gagal menyambungkan website ke database MySQL atau MariaDB. WordPress membutuhkan database untuk mengambil konten dan pengaturan website. Jika koneksi ini gagal, WordPress tidak bisa menampilkan halaman seperti biasa.

Penyebabnya bisa bermacam-macam, mulai dari username database salah, password database berubah, database server down, file wp-config.php bermasalah, database rusak, hosting kehabisan resource, hingga server MySQL tidak berjalan.

Di FirKaizen, kami sering menemukan error ini muncul setelah migrasi hosting, perubahan password database, update server, penggunaan resource berlebihan, atau website mengalami lonjakan traffic.

1. Cek File wp-config.php

Langkah pertama adalah mengecek file wp-config.php. File ini berisi informasi penting yang digunakan WordPress untuk terhubung ke database.

Biasanya, file tersebut berada di folder utama WordPress, misalnya public_html.

Data yang Perlu Dicek

Buka file wp-config.php, lalu perhatikan bagian berikut:

define('DB_NAME', 'nama_database');
define('DB_USER', 'user_database');
define('DB_PASSWORD', 'password_database');
define('DB_HOST', 'localhost');

Pastikan nama database, username, password, dan host sudah benar. Jika salah satu data tidak sesuai, WordPress tidak akan bisa terhubung ke database.

Jika error muncul setelah pindah hosting, kemungkinan besar detail database di wp-config.php belum disesuaikan dengan hosting baru.

2. Pastikan Database Masih Ada di Hosting

Kadang error terjadi bukan karena file WordPress bermasalah, tetapi karena database tidak ditemukan. Ini bisa terjadi setelah migrasi yang tidak sempurna, database terhapus, restore gagal, atau akun hosting mengalami masalah.

Cara Mengeceknya

Masuk ke cPanel atau panel hosting, lalu buka menu MySQL Databases atau phpMyAdmin. Pastikan database yang tertulis di wp-config.php benar-benar ada.

Jika database tidak ada, kamu perlu melakukan restore dari backup. Inilah alasan kenapa backup website sangat penting, terutama untuk website bisnis yang datanya terus bertambah.

Jika database ada, coba buka melalui phpMyAdmin. Jika phpMyAdmin juga tidak bisa mengakses database, kemungkinan masalahnya ada di server database atau permission user database.

3. Periksa Username dan Password Database

Username dan password database bisa berubah karena beberapa hal, misalnya setelah reset password, migrasi hosting, restore akun, atau perubahan konfigurasi dari panel hosting.

Jika password database di hosting berbeda dengan yang tertulis di wp-config.php, WordPress akan gagal terkoneksi.

Cara Mengatasinya

Masuk ke menu MySQL Databases di cPanel. Cek user database yang terhubung dengan database website. Jika ragu dengan password lama, kamu bisa membuat password baru untuk user database tersebut, lalu update nilai DB_PASSWORD di file wp-config.php.

Pastikan juga user database memiliki hak akses penuh terhadap database, seperti membaca, menulis, mengubah, dan menghapus data. Di cPanel, biasanya ada opsi Add User to Database dan pilihan privilege.

Kalau kamu ingin punya website WordPress yang lebih stabil, cepat, aman, dan tidak mudah mengalami error teknis seperti masalah koneksi database, FirKaizen siap membantu dari audit, perbaikan, optimasi performa, sampai pengembangan website profesional. Konsultasikan kebutuhan kamu melalui Jasa Pembuatan Website/Landing Page Premium FirKaizen agar website kamu punya fondasi teknis yang lebih rapi dan siap mendukung kebutuhan bisnis jangka panjang.

4. Cek Apakah Server Database Sedang Down

Pada beberapa hosting, database berjalan di server yang sama dengan file website. Namun, pada hosting tertentu, database bisa berada di server terpisah. Jika server database sedang bermasalah, WordPress akan gagal terhubung meskipun data login sudah benar.

Cara Mengeceknya

Coba akses phpMyAdmin dari panel hosting. Jika phpMyAdmin lambat, error, atau tidak bisa membuka database, kemungkinan server database sedang bermasalah.

Kamu juga bisa menghubungi support hosting dan menanyakan apakah service MySQL atau MariaDB sedang down. Untuk pengguna VPS, cek status database melalui SSH, misalnya service MySQL atau MariaDB apakah berjalan normal.

Jika database service berhenti, perlu dilakukan restart service. Namun, untuk pemula, sebaiknya minta bantuan support hosting agar tidak salah konfigurasi.

5. Perbaiki Database yang Rusak

Database WordPress bisa mengalami kerusakan karena server mati mendadak, proses update gagal, plugin bermasalah, atau tabel database corrupt. Jika ini terjadi, WordPress mungkin menampilkan error koneksi database atau pesan error lain di halaman admin.

Cara Mengatasinya

WordPress memiliki fitur repair database bawaan. Untuk mengaktifkannya, tambahkan baris berikut di file wp-config.php:

define('WP_ALLOW_REPAIR', true);

Setelah itu, buka URL berikut:

<https://domainkamu.com/wp-admin/maint/repair.php>

Pilih opsi repair database. Setelah selesai, segera hapus baris WP_ALLOW_REPAIR dari wp-config.php agar fitur tersebut tidak bisa diakses sembarang orang.

Sebelum memperbaiki database, sebaiknya buat backup terlebih dahulu jika masih memungkinkan.

6. Cek Resource Hosting atau VPS

Error database connection juga bisa muncul ketika hosting atau VPS kehabisan resource. Misalnya RAM penuh, CPU terlalu tinggi, jumlah koneksi database melebihi limit, atau server menerima traffic terlalu besar.

Ini sering terjadi pada website WordPress yang menggunakan banyak plugin berat, WooCommerce, page builder, atau sedang menerima lonjakan pengunjung dari iklan.

Cara Mengatasinya

Masuk ke panel hosting dan cek menu seperti Resource Usage, CPU Usage, atau statistik server. Jika resource sering mentok, kamu perlu melakukan optimasi.

Beberapa langkah yang bisa dilakukan antara lain mengaktifkan caching, mengurangi plugin berat, mengoptimalkan database, menggunakan CDN, dan memperbaiki query yang boros. Jika website memang sudah tumbuh besar, upgrade hosting atau VPS bisa menjadi solusi jangka panjang.

7. Hubungi Support Hosting Jika Masalah Belum Selesai

Jika semua langkah sudah dicek tetapi error masih muncul, segera hubungi support hosting. Minta mereka memeriksa status MySQL/MariaDB, error log, permission database, resource server, dan apakah ada limit koneksi database yang terlampaui.

Informasi yang Perlu Disiapkan

Agar proses bantuan lebih cepat, sampaikan domain yang bermasalah, waktu error mulai muncul, perubahan terakhir yang dilakukan, serta screenshot error jika ada. Jika error muncul setelah migrasi, beri tahu juga bahwa website baru saja dipindahkan.

Support hosting biasanya bisa melihat log server yang tidak bisa diakses dari dashboard WordPress biasa.

Kesimpulan: Error Database WordPress Bisa Diatasi dengan Pengecekan Bertahap

Error “Establishing a Database Connection” di WordPress biasanya terjadi karena detail database salah, database tidak ditemukan, password berubah, server database down, database rusak, atau hosting kehabisan resource. Cara terbaik mengatasinya adalah mengecek file wp-config.php, memastikan database tersedia, memeriksa user dan password database, mengecek status server, memperbaiki database jika rusak, serta memantau resource hosting.