Troubleshooting error pada WordPress menuntut pendekatan sistematis berdasarkan kode galat atau gejala visual yang muncul. Masalah paling sering bersumber dari konflik plugin, tema tidak kompatibel, habisnya batas memori PHP, atau kerusakan pada berkas inti (.htaccess dan wp-config.php). Langkah pertama yang wajib dilakukan sebelum melakukan perbaikan apa pun adalah melakukan pencadangan (backup) penuh pada basis data dan direktori situs melalui cPanel atau pengendali hosting Anda.
Tabel Gejala, Penyebab, dan Solusi Cepat WordPress Error
| Jenis Error | Gejala Utama | Penyebab Umum | Solusi Utama |
|---|---|---|---|
| White Screen of Death (WSoD) | Layar putih polos tanpa pesan error di frontend maupun backend. | Batas memori PHP habis atau error sintaks pada plugin/tema. | Tingkatkan memory_limit di wp-config.php atau nonaktifkan semua plugin via FTP. |
| Error Establishing a Database Connection | Teks merah peringatan gagal terhubung ke basis data saat memuat situs. | Kredensial database salah di wp-config.php atau server database down. | Periksa nama database, username, password, dan host pada berkas wp-config.php. |
| 500 Internal Server Error | Halaman menampilkan kode HTTP 500 saat diakses. | Berkas .htaccess korup atau batas memori PHP terlampaui. | Ganti nama berkas .htaccess menjadi .htaccess_old lalu buat ulang permalink. |
| Too Many Redirects (ERR_TOO_MANY_REDIRECTS) | Browser menolak memuat halaman karena perulangan pengalihan tak berujung. | Kesalahan pengaturan URL WordPress (Site URL vs WordPress URL) atau SSL. | Perbaiki URL di wp-config.php atau atur ulang paksa HTTPS. |
| Error 404 pada Halaman Postingan | Halaman beranda bisa diakses, namun semua post/halaman lain menghasilkan 404 Not Found. | Berkas .htaccess rusak atau aturan permalink terhapus. | Masuk ke Pengaturan > Permalink, lalu klik tombol Simpan Perubahan dua kali. |
Langkah Teknis Mengatasi Error Umum WordPress
1. Mengatasi White Screen of Death (WSoD)
Jika situs Anda menampilkan layar putih total, aktifkan mode debug untuk melihat pesan galat yang tersembunyi. Akses direktori root situs Anda menggunakan FTP Client (seperti FileZilla) atau File Manager di cPanel, lalu sunting berkas wp-config.php.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );Jika pesan error menunjukkan fungsi memori habis (memory limit exhausted), tambahkan baris berikut di bawah kode di atas:
define( 'WP_MEMORY_LIMIT', '256M' );2. Memperbaiki Error Establishing a Database Connection
Pesan ini mengindikasikan WordPress tidak dapat berkomunikasi dengan MySQL/MariaDB. Buka berkas wp-config.php dan pastikan parameter berikut sesuai dengan panel database hosting Anda:
define( 'DB_NAME', 'nama_database_anda' );
define( 'DB_USER', 'username_database_anda' );
define( 'DB_PASSWORD', 'password_database_anda' );
define( 'DB_HOST', 'localhost' );Jika parameter tersebut sudah benar namun error berlanjut, hubungi penyedia layanan hosting Anda untuk memastikan server database sedang beroperasi normal.
3. Menangani Plugin dan Tema yang Menyebabkan Crash
Jika Anda tidak bisa mengakses dashboard administrator karena error setelah memasang plugin atau tema baru, matikan seluruh plugin secara manual melalui File Manager hosting:
- Masuk ke direktori
wp-content/. - Ubah nama folder
pluginsmenjadiplugins_old. - Cek situs Anda. Jika kembali normal, ubah kembali nama folder menjadi
plugins, lalu aktifkan plugin satu persatu dari dashboard untuk menemukan plugin penyebab masalah.
Tips Pencegahan Agar Situs Tidak Mudah Error
Sebagian besar error dapat dicegah dengan menerapkan praktik pemeliharaan rutin. Selalu lakukan pembaruan (update) inti WordPress, tema, dan plugin hanya dari sumber resmi. Gunakan versi PHP yang direkomendasikan oleh penyedia hosting (minimal PHP 8.0 atau yang lebih baru) untuk menjaga kompatibilitas kode dan keamanan sistem secara keseluruhan.