wpcamp.web.id

Tutorial WordPress untuk audiens Indonesia, plugin pilihan, troubleshooting umum

Cara Mengatasi Error 500 di WordPress: Panduan Lengkap

by Dewi Larasati
Cara Mengatasi Error 500 di WordPress: Panduan Lengkap

Cara Mengatasi Error 500 di WordPress: Panduan Lengkap

Kamu baru saja membuka website WordPress dan tiba-tiba muncul pesan putih kosong atau tulisan "Error 500 – Internal Server Error". Pengunjung tidak bisa masuk, penjualan terhenti, dan kamu panik mencari solusi.

Error 500 adalah pesan dari server yang berarti ada sesuatu yang salah di belakang layar, tapi server tidak bisa menjelaskan detail masalahnya. Kabar baiknya: kebanyakan error 500 di WordPress bisa kamu perbaiki sendiri dalam 15–30 menit tanpa harus bayar developer.

Artikel ini menunjukkan cara mengatasi error 500 di WordPress dengan langkah praktis yang sudah terbukti berhasil.

Apa Itu Error 500 dan Mengapa Muncul?

Error 500 berarti server WordPress kamu sedang mengalami masalah saat memproses permintaan dari pengunjung. Penyebab paling umum adalah:

  • Plugin atau tema yang tidak kompatibel
  • Batas memori PHP yang terlalu rendah
  • File .htaccess yang rusak
  • Masalah dengan database
  • Versi PHP yang tidak cocok dengan plugin lama

Perbedaan dengan error lain: error 404 berarti halaman tidak ditemukan, tapi error 500 berarti servermu "bingung" bagaimana menangani permintaan tersebut.

Langkah 1: Aktifkan Debug Mode untuk Melihat Pesan Error Sebenarnya

WordPress punya mode debug yang bisa menunjukkan penyebab sebenarnya. Ini langkah pertama dan paling penting.

Apa yang akan kamu lihat: File wp-config.php di folder root website kamu (bukan folder lain).

  1. Buka file manager hosting kamu (biasanya di cPanel atau Plesk). Cari folder bernama public_html atau nama domain kamu.
  2. Di dalam folder itu, cari file wp-config.php. Klik kanan → Edit.
  3. Cari baris yang berisi: 
    define('WP_DEBUG', false);
  4. Ubah menjadi: 
    define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
  5. Klik Save.

Sekarang WordPress akan mencatat error ke file bernama debug.log di folder /wp-content/. Buka file itu untuk melihat pesan error yang sebenarnya—biasanya di sini sudah ketahuan penyebabnya.

⚠️ Penting: Jangan tinggalkan mode debug aktif selamanya. Setelah selesai troubleshooting, ubah WP_DEBUG kembali ke false.

Langkah 2: Nonaktifkan Semua Plugin

Plugin adalah penyebab paling sering error 500. Kamu perlu menemukan plugin mana yang bermasalah.

  1. Login ke WordPress dashboard kamu (jika masih bisa akses).
  2. Jika tidak bisa login, gunakan file manager untuk masuk ke folder /wp-content/plugins/.
  3. Rename folder plugin pertama menjadi plugin-name-old (contoh: woocommerce-old).
  4. Cek website kamu. Apakah error 500 hilang?
    • Jika hilang: Plugin itu penyebabnya. Kamu bisa update plugin atau hapus dan cari alternatif.
    • Jika masih ada: Rename folder itu kembali ke nama asli, lalu coba plugin berikutnya.
  5. Ulangi sampai kamu menemukan plugin yang bermasalah.

Catatan: Jika kamu punya banyak plugin (lebih dari 10), ini butuh waktu. Tapi ini cara paling efektif untuk menemukan culprit-nya.

Langkah 3: Tingkatkan Batas Memori PHP

WordPress membutuhkan memori untuk menjalankan kode. Jika batas terlalu rendah, muncul error 500.

  1. Buka file wp-config.php lagi (sama seperti Langkah 1).
  2. Cari baris paling atas (sebelum <?php) atau cari baris yang sudah ada define('WP_MEMORY_LIMIT'.
  3. Tambahkan baris ini (jika belum ada): 
    define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
  4. Klik Save dan cek website.

Nilai standar adalah 40M, tapi website modern butuh minimal 256M. Jika masih error, coba naik ke 512M.

⚠️ Perhatian: Jika hosting kamu tidak mengizinkan, kamu akan lihat pesan error lagi. Hubungi support hosting untuk minta naikkan memory limit.

Langkah 4: Periksa dan Perbaiki File .htaccess

File .htaccess mengatur bagaimana server menangani permintaan ke website. File ini bisa rusak atau conflict dengan plugin. Jika kamu ingin website lebih optimal ke depannya, memahami struktur URL SEO friendly untuk ranking juga bisa membantu kamu menyusun konfigurasi .htaccess yang lebih baik.

  1. Buka file manager, cari file .htaccess di folder root (folder public_html).
  2. Jika file ini ada, download dulu sebagai backup.
  3. Hapus file .htaccess (jangan khawatir, WordPress bisa membuat yang baru).
  4. Login ke WordPress dashboard → Settings → Permalinks.
  5. Klik tombol "Save Changes" (jangan ubah apa pun, cukup save).

WordPress akan membuat file .htaccess yang baru dan benar. Cek website kamu—biasanya error 500 hilang di sini.

Jika error 500 masih ada setelah file baru dibuat, berarti masalahnya bukan .htaccess.

Langkah 5: Cek Kompatibilitas PHP dan Database

WordPress membutuhkan versi PHP tertentu. Plugin lama mungkin tidak cocok dengan PHP versi baru.

  1. Login ke cPanel hosting kamu.
  2. Cari "Select PHP Version" atau "PHP Version".
  3. Lihat versi PHP yang digunakan (biasanya tertulis 7.4, 8.0, 8.1, atau lebih baru).
  4. Cek di dashboard WordPress kamu: Tools → Site Health.
  5. Di sini terlihat apakah ada masalah kompatibilitas.

Jika versi PHP sangat baru (8.2+) dan plugin kamu lama (dibuat tahun 2015), mungkin ada konflik. Solusinya:

  • Update plugin ke versi terbaru
  • Atau downgrade PHP ke versi yang lebih lama (hubungi support hosting)
  • Atau cari plugin alternatif yang lebih baru

Langkah 6: Hubungi Support Hosting (Jika Masih Error)

Jika sudah coba semua langkah di atas dan error 500 masih muncul, masalahnya kemungkinan di server.

Buka ticket support hosting kamu dan sertakan:

  • Screenshot error 500
  • Isi file debug.log (dari Langkah 1)
  • Versi WordPress, PHP, dan tema kamu

Support hosting biasanya bisa lihat log server yang lebih detail dan membantu dalam 24 jam.

Tips Mencegah Error 500 di Masa Depan

  1. Update teratur: Update WordPress, plugin, dan tema setiap minggu.
  2. Backup sebelum update: Jika ada error, kamu bisa restore.
  3. Pilih plugin terpercaya: Gunakan plugin dari wordpress.org atau developer terkenal. Hindari plugin gratis dari situs asal-asalan.
  4. Monitor batas memori: Jika website sering lambat, naikkan memory limit sebelum error 500 muncul.
  5. Gunakan caching plugin: Plugin seperti WP Super Cache atau Cloudflare mengurangi beban server.

Langkah Berikutnya

Setelah error 500 hilang:

  1. Matikan debug mode di wp-config.php (ubah WP_DEBUG ke false).
  2. Hapus file debug.log dari folder /wp-content/.
  3. Update semua plugin dan tema ke versi terbaru.
  4. Pasang backup plugin seperti UpdraftPlus atau BackWPup untuk mencegah kehilangan data.

Website kamu sekarang seharusnya berjalan normal. Jika error 500 muncul lagi di masa depan, kamu sudah tahu langkah-langkah di atas dan bisa mengulanginya sendiri.