Solusi Error Establishing a Database Connection di Website WordPress

Jika website WordPress Anda menampilkan pesan "Error establishing a database connection", berarti WordPress gagal terhubung ke server database. Masalah ini dapat menghentikan seluruh situs, sehingga perlu penanganan cepat dan tepat.

Penyebab umum error ini

• Kredensial database (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST) di wp-config.php salah.
• Server MySQL/MariaDB tidak berjalan atau mengalami overload.
• Hak akses file wp-config.php atau folder wp-content tidak tepat.
• Database korup atau tabel wp_options rusak.
• Limit memori PHP terlalu rendah.

Langkah-langkah memperbaiki

1. Langkah 1: Verifikasi kredensial di wp-config.php

   Buka file wp-config.php yang berada di root instalasi WordPress dan pastikan nilai berikut sesuai dengan database Anda:

   define('DB_NAME', 'nama_database');
   define('DB_USER', 'nama_user');
   define('DB_PASSWORD', 'kata_sandi');
   define('DB_HOST', 'localhost'); // atau IP/port khusus
   

   Jika Anda menggunakan layanan hosting yang menyediakan socket, ubah DB_HOST menjadi contoh localhost:/var/run/mysqld/mysqld.sock.

2. Langkah 2: Uji koneksi via WP‑CLI

   Masuk ke server melalui SSH, lalu jalankan perintah berikut:

   wp db check --path=/path/ke/wordpress

   Jika koneksi berhasil, WP‑CLI akan menampilkan Success: Database check completed.. Jika gagal, catat pesan error untuk langkah selanjutnya.

3. Langkah 3: Pastikan service MySQL aktif

   Gunakan perintah systemctl (atau service) untuk memeriksa status MySQL/MariaDB:

   sudo systemctl status mysql
   # atau
   sudo service mariadb status

   Jika service tidak berjalan, hidupkan dengan:

   sudo systemctl start mysql   # atau mariadb
   sudo systemctl enable mysql  # otomatis start setelah reboot

   Periksa log error di /var/log/mysql/error.log bila service gagal start.

4. Langkah 4: Perbaiki hak akses file

   WordPress memerlukan hak akses yang ketat untuk wp-config.php demi keamanan, namun tetap dapat dibaca oleh PHP. Jalankan:

   sudo chmod 640 wp-config.php
   sudo chown www-data:www-data wp-config.php   # ganti www-data dengan user web server Anda

   Pastikan folder wp-content memiliki hak akses 755:

   sudo chmod -R 755 wp-content
   sudo chown -R www-data:www-data wp-content

5. Langkah 5: Reset password database

   Jika Anda ragu passwordnya benar, buat password baru lewat MySQL client:

   sudo mysql -u root -p
   ALTER USER 'nama_user'@'localhost' IDENTIFIED BY 'kata_sandi_baru';
   FLUSH PRIVILEGES;
   EXIT;

   Setelah itu, perbarui wp-config.php dengan password baru dan ulangi Langkah 2 untuk memastikan koneksi berhasil.

6. Langkah 6: Cek limit memori PHP

   Jika server kehabisan memori, MySQL dapat menolak koneksi. Tambahkan atau tingkatkan nilai memory_limit di php.ini:

   memory_limit = 256M

   Restart PHP-FPM atau Apache setelah perubahan:

   sudo systemctl restart php7.4-fpm   # sesuaikan versi PHP
   sudo systemctl restart apache2

7. Langkah 7: Periksa integritas tabel database

   Jika database korup, jalankan perbaikan via WP‑CLI atau phpMyAdmin:

   wp db repair --path=/path/ke/wordpress

   Atau secara manual di MySQL:

   mysqlcheck -u nama_user -p --auto-repair --databases nama_database

"Tim AN Media selalu menyarankan klien untuk melakukan backup penuh sebelum mengubah konfigurasi database. Langkah-langkah di atas telah terbukti mengembalikan 97% situs WordPress yang mengalami error koneksi database dalam hitungan menit." – Ahmad Fauzi, Lead Engineer AN Media

Kesimpulan & Call to Action

Dengan memeriksa kredensial, memastikan service MySQL berjalan, memperbaiki hak akses, serta menyesuaikan limit memori, Anda dapat mengatasi error Establishing a Database Connection secara menyeluruh. Jika masalah masih berlanjut, hubungi tim ahli AN Media di Jember untuk audit server dan optimasi WordPress profesional.

Hubungi kami sekarang untuk konsultasi gratis dan pastikan website Anda tetap online 24/7.