Cara Mengatasi 'Error Establishing a Database Connection' di WordPress

Pesan 'Error Establishing a Database Connection' berarti WordPress gagal menghubungi database MySQL.

WordPress & Website Oleh Tim Teknis Webhostmu · Diperbarui 18 November 2026 · Estimasi baca 2 menit
Daftar Isi Panduan Ini

Ringkasan & Catatan

Pesan 'Error Establishing a Database Connection' berarti WordPress gagal menghubungi database MySQL. Solusi utamanya adalah mencocokkan kembali DB_NAME, DB_USER, DB_PASSWORD, dan DB_HOST ('localhost') pada file wp-config.php dengan data pengguna database yang terdaftar di cPanel MySQL Databases.


Prasyarat Sebelum Memulai

  • Akses login ke cPanel Webhostmu.
  • File Manager cPanel untuk menyunting file wp-config.php.

Langkah-Langkah Penyelesaian

Langkah 1: Buka File Manager di cPanel

Masuk ke cPanel Webhostmu > buka File Manager > masuk ke folder public_html.

Langkah 2: Edit File wp-config.php

Cari file bernama wp-config.php, klik kanan dan pilih Edit.

Langkah 3: Periksa Baris Parameter Database

Perhatikan 4 baris kode konfigurasi ini:

define( 'DB_NAME', 'usercpanel_namadb' );
define( 'DB_USER', 'usercpanel_userdb' );
define( 'DB_PASSWORD', 'PasswordAnda' );
define( 'DB_HOST', 'localhost' );

Langkah 4: Cocokkan dengan cPanel MySQL Databases

Buka tab baru cPanel > menu MySQL Databases:

  • Pastikan nama database sama persis (termasuk awalan prefix).
  • Pastikan user database terdaftar dan sudah ditautkan ke database tersebut dengan hak ALL PRIVILEGES.

Langkah 5: Reset Password User Database

Pada halaman MySQL Databases, cari user database Anda di tabel Current Users, klik tombol Change Password, buat password baru, lalu salin password tersebut ke dalam parameter DB_PASSWORD di file wp-config.php.

Langkah 6: Simpan dan Muat Ulang Website

Klik Save Changes pada editor wp-config.php, lalu muat ulang website Anda di browser.

Tips Praktis

Pastikan parameter DB_HOST selalu bernilai 'localhost' di lingkungan hosting cPanel Webhostmu.


Tanya Jawab & Kendala Umum (FAQ)

Tanya: Mengapa error ini muncul tiba-tiba padahal saya tidak mengubah file apapun?
Jawab: Bisa terjadi jika server MySQL kehabisan sumber daya sementara atau ada tabel database yang rusak (crashed). Anda bisa menambahkan define('WP_ALLOW_REPAIR', true); di wp-config.php untuk menjalankan alat perbaikan otomatis.

Tanya: Apakah data artikel saya hilang saat error ini terjadi?
Jawab: Sama sekali tidak. Tabel database Anda tetap aman; sistem hanya gagal melakukan autentikasi koneksi saja.


Butuh Bantuan Teknisi Webhostmu?

Jika Anda ragu atau terkendala pada salah satu langkah konfigurasi di atas, tim teknis Webhostmu siap membantu menyelesaikannya untuk Anda. Silakan buka tiket bantuan di Member Area Webhostmu atau hubungi WhatsApp resmi Webhostmu dengan menyertakan nama domain Anda.