Mengatasi Error Establishing a Database Connection di WordPress: Panduan Langkah Demi Langkah

Bagi siapa saja yang mengelola website dengan WordPress, membuka halaman situs dan disambut oleh layar putih polos dengan teks tebal berbunyi Error establishing a database connection adalah momen yang memicu kepanikan luar biasa. Website toko atau company profile Anda mati total, pengunjung tidak bisa membaca artikel Anda, dan halaman login admin WordPress di wp-admin pun ikut lumpuh tidak bisa diakses sama sekali.

Pesan galat fatal ini terjadi karena aplikasi WordPress gagal menjalin komunikasi dengan server basis data MySQL atau MariaDB tempat seluruh artikel, pengaturan, kata sandi akun, dan komentar tersimpan. Tanpa adanya jembatan data tersebut, mesin WordPress tidak mampu merender halaman apa pun.

Kabar baiknya, galat ini bukan akhir dari segalanya. Masalah ini sangat umum terjadi di layanan shared hosting cPanel murah di Indonesia dan hampir selalu bisa diselesaikan tanpa perlu merombak website dari awal.

Berikut adalah empat langkah sistematis dan terbukti untuk mendiagnosa sekaligus memulihkan website WordPress Anda dalam waktu kurang dari lima belas menit.

Langkah 1: Periksa Kredensial di Berkas wp-config.php

Penyebab nomor satu dari galat ini, terutama setelah Anda melakukan migrasi hosting atau mengubah password akun hosting, adalah ketidakcocokan antara informasi login yang dicatat oleh WordPress dengan pengaturan di server basis data.

WordPress menyimpan informasi kunci koneksi ini di berkas bernama wp-config.php yang terletak di folder utama website Anda.

• Buka File Manager di cPanel hosting Anda, lalu masuk ke direktori public_html.
• Klik kanan pada berkas wp-config.php lalu pilih opsi Edit.
• Cari baris-baris kode berikut:

// ** Pengaturan Basis Data MySQL ** //
define( 'DB_NAME', 'nama_database_anda' );
define( 'DB_USER', 'nama_user_anda' );
define( 'DB_PASSWORD', 'kata_sandi_rahasia_anda' );
define( 'DB_HOST', 'localhost' );

Pastikan keempat parameter di atas benar:

• DB_NAME: Nama basis data yang sesuai di cPanel. Di lingkungan shared hosting, nama basis data biasanya diawali dengan awalan nama pengguna cPanel, misalnya cpaneluser_wpdb.
• DB_USER: Pengguna basis data yang sah, seringkali juga diawali awalan cPanel, misalnya cpaneluser_dbuser.
• DB_PASSWORD: Kata sandi pengguna basis data. Jika ragu, Anda bisa mereset kata sandi pengguna basis data ini di menu MySQL Databases cPanel, lalu menyalin kata sandi baru ke baris ini.
• DB_HOST: Sebagian besar penyedia hosting lokal menggunakan nilai localhost. Namun pada beberapa penyedia cloud tertentu, nilai ini bisa berupa alamat IP atau alamat peladen basis data eksternal.

Langkah 2: Pastikan Pengguna MySQL Memiliki Hak Akses Penuh (User Privileges)

Seringkali nama database dan kata sandi sudah benar, tetapi pengguna MySQL tersebut belum dihubungkan ke database yang bersangkutan, atau hak aksesnya terlepas.

Cara memperbaikinya di cPanel:

• Masuk ke dashboard cPanel Anda, lalu klik menu MySQL Databases.
• Gulir ke bagian bawah pada tabel bernama Add User to Database.
• Pilih nama pengguna Anda di menu dropdown User, dan pilih nama database Anda di dropdown Database, lalu klik tombol Add.
• Pada halaman perizinan yang muncul, beri tanda centang pada opsi ALL PRIVILEGES.
• Klik tombol Make Changes untuk menyimpan aturan.

Langkah ini memastikan pengguna memiliki wewenang penuh untuk membaca, menulis, dan memperbarui tabel basis data website Anda.

Langkah 3: Gunakan Fitur Pemulihan Otomatis WordPress (WP_ALLOW_REPAIR)

Terkadang, galat koneksi terjadi bukan karena salah password, melainkan karena ada satu atau dua tabel basis data yang mengalami kerusakan mendadak akibat proses simpan yang terputus atau server yang mati tiba-tiba saat pembaruan berlangsung.

Ciri khasnya: halaman depan website menampilkan tulisan Error establishing a database connection, tetapi ketika Anda mencoba membuka wp-admin, pesan yang muncul sedikit berbeda, misalnya One or more database tables are unavailable.

WordPress menyediakan utilitas perbaikan tabel bawaan tanpa perlu membuka phpMyAdmin:

• Buka kembali berkas wp-config.php melalui File Manager cPanel.
• Tambahkan satu baris kode berikut tepat di atas baris bertuliskan /* That's all, stop editing! Happy publishing. */:

define( 'WP_ALLOW_REPAIR', true );

• Simpan perubahan berkas, lalu buka browser Anda dan akses alamat berikut:

https://namadomainanda.com/wp-admin/maint/repair.php

• Klik tombol Repair and Optimize Database. WordPress akan memindai seluruh tabel dan memperbaiki bagian yang korup secara otomatis.
• Penting: Setelah proses perbaikan selesai dan website normal kembali, segera buka kembali berkas wp-config.php dan hapus baris define( 'WP_ALLOW_REPAIR', true ); tersebut. Jika dibiarkan aktif, siapa saja di internet bisa memicu proses perbaikan yang dapat membebani server hosting Anda.

Langkah 4: Cek Batas Sumber Daya Hosting (Resource Limit / Server Down)

Jika ketiga langkah di atas sudah dipastikan beres tetapi website tetap menampilkan pesan galat yang sama, masalahnya kemungkinan besar berada pada kapasitas peladen hosting itu sendiri.

Pada paket shared hosting murah, penyedia hosting membatasi jumlah koneksi bersamaan ke basis data MySQL (biasanya antara 15 hingga 30 koneksi paralel). Jika website Anda tiba-tiba diserbu oleh bot peretas yang mencoba login bertubi-tubi, atau ada lonjakan pengunjung yang tidak diimbangi oleh sistem caching, kuota koneksi MySQL akan habis seketika. Akibatnya, server MySQL menolak koneksi baru dan memicu pesan galat basis data.

Cara memeriksanya:

• Buka dashboard cPanel Anda, lihat panel samping kanan pada bagian CPU Usage, Physical Memory Usage, dan I/O Usage.
• Jika indikator tersebut berwarna merah atau menyentuh angka 100 persen, berarti server hosting Anda kehabisan daya komputasi untuk menjalankan service MySQL.
• Hubungi tim bantuan teknis atau customer support penyedia hosting Anda. Tanyakan apakah peladen MySQL mereka sedang mengalami gangguan atau apakah akun Anda terkena pembatasan sementara.

Menghadapi galat basis data di WordPress memang membuat cemas, tetapi dengan pendekatan yang tenang dan bertahap dari pengecekan berkas konfigurasi hingga perizinan pengguna, website kesayangan Anda hampir selalu dapat kembali online tanpa kehilangan satu pun data penting.

—

**