Cara Mengatasi White Screen of Death di WordPress
Layar putih kosong. Tidak ada tombol, tidak ada pesan error, cuma putih polos seperti kanvas yang lupa diisi. Kalau kamu baru saja mengalami ini di website WordPress, itu namanya White Screen of Death (WSOD) — dan ya, cara mengatasi white screen of death di WordPress sebenarnya jauh lebih sederhana dari yang terlihat.
Saya pernah menangani kasus serupa lebih dari sekali, dan pola yang muncul hampir selalu sama: panik dulu, baru cari solusi. Padahal urutannya harusnya dibalik. Artikel ini akan membawa kamu lewat diagnosis cepat, tujuh langkah perbaikan yang terurut dari paling ringan ke paling teknis, sampai cara mencegahnya terulang.
Apa Itu White Screen of Death dan Kenapa Tidak Ada Pesan Error?
WSOD terjadi ketika PHP menghentikan eksekusinya di tengah jalan karena fatal error, tapi pengaturan server sengaja menyembunyikan pesan error itu dari publik. Alasannya masuk akal: menampilkan stack trace PHP ke pengunjung sama saja membocorkan struktur server ke orang iseng. Jadi yang tersisa cuma halaman kosong.
Kabar baiknya, sejak WordPress 5.2 rilis, situasi ini sudah lebih jinak. WordPress sekarang punya semacam jaring pengaman bawaan yang menangkap sebagian besar fatal error dari plugin atau tema, lalu menampilkan pesan "terjadi kesalahan kritis" ketimbang layar putih polos — sekaligus mengirim email pemulihan ke alamat admin. Masalahnya, banyak tutorial di internet masih ditulis seolah-olah fitur ini tidak ada. Itu salah satu alasan kenapa orang masih bingung meski sebenarnya WordPress sudah membantu lebih dari yang mereka sadari.
Cek Email Recovery Mode Dulu Sebelum Utak-Atik Apa Pun
Ini langkah yang paling sering dilewatkan. Buka inbox email yang terdaftar di Pengaturan → Umum → Alamat Email Administrasi. Cari subjek "Your Site is Experiencing a Technical Issue". Kalau ketemu, klik link di dalamnya — kamu akan masuk ke mode pemulihan yang otomatis menonaktifkan plugin atau tema bermasalah, tanpa menyentuh file sama sekali.
Tidak ketemu emailnya? Jangan langsung berkesimpulan sistemnya gagal. Bisa jadi alamat emailnya sudah tidak aktif, masuk folder spam, fitur pengiriman email di hosting-mu diblokir, atau errornya terjadi terlalu dini sehingga handler WordPress belum sempat jalan. Kalau begini, lanjut ke langkah manual di bawah.
Diagnosis Cepat: Tiga Pertanyaan Sebelum Panik
Sebelum masuk ke perbaikan teknis, jawab tiga hal ini dulu — jawabannya akan menentukan langkah mana yang paling relevan buat kasusmu:
- Apakah kamu baru saja update atau install plugin baru?
- Apakah kamu baru mengganti tema atau mengedit file functions.php?
- Apakah hosting-mu baru saja mengubah versi PHP secara otomatis?
Kalau salah satu jawabannya "ya", kemungkinan besar kamu sudah tahu tersangkanya. Tinggal konfirmasi lewat langkah-langkah berikut.
Bersihkan Cache Browser dan Cache WordPress Lebih Dulu
Kadang bukan situsnya yang rusak — browser kamu saja yang masih menyimpan versi lama halaman. Hapus cache browser lewat Clear Browsing Data, lalu buka ulang di jendela incognito. Kalau kamu pakai plugin cache seperti WP Rocket, LiteSpeed Cache, atau W3 Total Cache, bersihkan juga cache dari sisi WordPress-nya. Langkah ini kadang menyelesaikan masalah dalam waktu kurang dari semenit, tanpa perlu sentuh kode sama sekali.
Nonaktifkan Plugin Satu per Satu Lewat FTP
Plugin adalah biang keladi paling umum untuk WSOD — dan bukan tanpa alasan, mengingat mayoritas kerentanan WordPress di ekosistem plugin justru bersumber dari plugin itu sendiri. Kalau dashboard masih bisa diakses, tinggal nonaktifkan semua plugin lewat menu Plugins, lalu aktifkan satu per satu sambil cek website tiap kali.
Kalau dashboard ikut blank, masuk lewat FTP client seperti FileZilla ke folder wp-content/plugins. Ganti nama folder plugin yang dicurigai, misalnya dari woocommerce jadi woocommerce-nonaktif. Ini secara efektif mematikan plugin tanpa menghapusnya. Refresh website. Kalau sudah normal, berarti plugin itu penyebabnya — tinggal update, ganti, atau hubungi developer-nya untuk cari patch.
Ganti Tema ke Default Kalau Plugin Bukan Penyebabnya
Kalau semua plugin sudah dicek dan situs masih blank, giliran tema yang jadi tersangka. Caranya mirip: masuk ke wp-content/themes lewat FTP, ganti nama folder tema aktif. WordPress otomatis akan fallback ke tema default seperti Twenty Twenty-Four kalau tema itu masih terpasang.
Situs normal lagi? Berarti temanya yang bermasalah. Bisa karena tema belum diperbarui untuk mendukung versi WordPress atau PHP terbaru, atau ada custom code di functions.php yang salah ketik — satu titik koma hilang saja cukup untuk menjatuhkan seluruh situs.
Naikkan Batas Memori PHP Lewat wp-config.php
Kalau plugin dan tema sudah bersih tapi WSOD masih muncul, kemungkinan besar situsmu kehabisan alokasi memori PHP. Ini sering terjadi saat menjalankan plugin builder halaman, plugin backup, atau saat traffic sedang naik.
Buka wp-config.php lewat FTP, cari baris sebelum /* That's all, stop editing! */, lalu tambahkan:
define('WP_MEMORY_LIMIT', '256M');
Kenapa ini bekerja? Karena WordPress menghentikan proses PHP begitu memori yang dialokasikan habis di tengah render halaman. Menaikkan batasnya memberi ruang napas ekstra. Tapi ini bukan solusi ajaib — kalau hosting-mu memang membatasi memori di level server, kamu tetap perlu upgrade paket hosting atau hubungi provider untuk menaikkan limit dari sisi mereka.
Aktifkan WP_DEBUG untuk Menemukan Akar Masalah Sesungguhnya
Semua langkah di atas sifatnya trial-and-error. Kalau kamu mau tahu persis apa yang error, aktifkan mode debug. Masih di file yang sama, ubah baris WP_DEBUG jadi:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Perhatikan baris terakhir — WP_DEBUG_DISPLAY sengaja diset false supaya error tidak tampil ke pengunjung publik, tapi tetap tercatat di wp-content/debug.log. Buka file log itu dan cari baris "Fatal error". Biasanya di situ tertulis jelas nama file dan nomor baris penyebabnya, misalnya "Call to undefined function di plugin XYZ baris 55". Setelah selesai troubleshooting, jangan lupa kembalikan WP_DEBUG ke false — membiarkannya aktif di situs live adalah risiko keamanan.
Periksa File .htaccess yang Mungkin Korup
Jarang, tapi terjadi. File .htaccess yang rusak — biasanya gara-gara plugin yang menulis rewrite rule sembarangan — bisa membuat seluruh routing situs berantakan. Rename file .htaccess di root direktori jadi .htaccess_old, lalu cek situs. Kalau pulih, generate ulang file baru lewat Pengaturan → Permalink, klik Simpan Perubahan tanpa mengubah apa pun. WordPress akan menulis ulang file default secara otomatis.
Studi Kasus: Dari Panik ke Pulih dalam 40 Menit
Sebagai ilustrasi — bukan kejadian nyata, tapi menggambarkan alur yang sering saya temui — bayangkan seorang pengelola blog bernama Dinda. Situsnya blank total pukul 22.17 malam, tepat setelah update otomatis plugin galeri foto. Dinda sempat coba reinstall WordPress dari nol (langkah yang sebenarnya tidak perlu), sebelum akhirnya cek email dan menemukan notifikasi Recovery Mode yang terlewat tiga jam sebelumnya. Klik link, plugin galeri otomatis ter-nonaktifkan, situs pulih. Total waktu yang harusnya dibutuhkan: sekitar 6 menit. Karena panik duluan, prosesnya molor jadi 40 menit.
Tabel Penyebab, Solusi, dan Estimasi Waktu Perbaikan
| Penyebab | Solusi Utama | Estimasi Waktu |
|---|---|---|
| Konflik plugin | Nonaktifkan lewat FTP satu per satu | 5-15 menit |
| Konflik tema | Rename folder tema, fallback ke default | 5-10 menit |
| Memori PHP habis | Naikkan WP_MEMORY_LIMIT | 2-5 menit |
| .htaccess korup | Rename file, generate ulang lewat Permalink | 3-5 menit |
| Update core gagal | Upload ulang file wp-admin & wp-includes | 10-20 menit |
Mencegah WSOD Supaya Tidak Terulang Bulan Depan
Setelah situs pulih, jangan berhenti di situ saja. Beberapa kebiasaan yang layak dipertahankan: backup rutin sebelum update apa pun, pakai staging site untuk mencoba plugin atau tema baru, dan hindari menginstal plugin dari sumber yang tidak jelas asal-usulnya. Update satu per satu, bukan sekaligus massal — supaya kalau ada yang bermasalah, kamu langsung tahu siapa pelakunya.
Satu lagi yang jarang disebut: pertimbangkan pasang plugin Health Check & Troubleshooting. Fungsinya mirip mode aman — bisa menonaktifkan semua plugin dan ganti ke tema default khusus untuk sesi browser-mu sendiri, tanpa mengganggu tampilan yang dilihat pengunjung lain.
Dan satu catatan jujur: tidak semua WSOD bisa dicegah 100%. Kadang penyebabnya di luar kendali kamu — server hosting yang tiba-tiba upgrade versi PHP tanpa pemberitahuan, misalnya. Yang bisa kamu kontrol cuma seberapa cepat kamu pulih ketika itu terjadi.
Pertanyaan yang Sering Ditanyakan Soal White Screen of Death
Apakah WSOD berarti data website saya hilang?
Hampir selalu tidak. WSOD adalah gejala kegagalan render, bukan kerusakan database. Konten, komentar, dan pengaturan biasanya tetap utuh di database — masalahnya ada di eksekusi kode, bukan datanya.
Berapa lama biasanya WSOD bisa diperbaiki?
Kalau penyebabnya plugin atau tema (yang paling umum), biasanya selesai dalam 5-15 menit begitu kamu tahu caranya. Kasus yang melibatkan file core yang rusak bisa makan waktu lebih lama.
Apakah reinstall WordPress dari nol perlu dilakukan?
Jarang sekali diperlukan. Ini langkah paling drastis dan biasanya bukan solusi pertama yang tepat — coba dulu langkah-langkah bertahap di atas.
Kenapa WordPress saya tidak mengirim email Recovery Mode?
Beberapa kemungkinan: alamat email admin sudah tidak aktif, fungsi pengiriman email di server diblokir, notifikasinya masuk folder spam, atau errornya terjadi terlalu awal sebelum sistem pemulihan sempat berjalan.
Apakah aman melakukan langkah-langkah di atas sendiri tanpa developer?
Untuk sebagian besar kasus, ya — asal kamu backup dulu sebelum edit file apa pun. Kalau sudah masuk ke wilayah file core yang rusak parah atau dicurigai ada indikasi peretasan, itu saatnya minta bantuan yang lebih teknis.
Ringkasan Langkah Mengatasi White Screen of Death
- Cek dulu email Recovery Mode sebelum melakukan apa pun secara manual.
- Bersihkan cache browser dan cache WordPress — kadang cuma itu yang dibutuhkan.
- Nonaktifkan plugin satu per satu lewat FTP kalau dashboard tidak bisa diakses.
- Ganti tema ke default untuk memastikan bukan tema yang jadi penyebabnya.
- Naikkan WP_MEMORY_LIMIT kalau dugaan mengarah ke kehabisan memori PHP.
- Aktifkan WP_DEBUG untuk melacak akar masalah secara pasti, lalu matikan lagi setelah selesai.
Layar putih itu memang bikin jantung berdegup lebih cepat sesaat. Tapi begitu tahu urutan diagnosisnya, WSOD berubah dari mimpi buruk jadi checklist rutin. Sudah pernah coba salah satu langkah di atas? Atau ada kasus WSOD yang aneh dan belum terpecahkan di website kamu? Ceritakan di kolom komentar.
💬 Diskusi & Komentar (0)
Bagikan tanggapan, pertanyaan, atau ide Anda mengenai artikel ini di bawah:
Comments
Post a Comment