Lewati ke isi

Website & Domain

WordPress Layar Putih Kosong, Penyebab dan Solusinya

Analisis penyebab layar putih kosong di WordPress, dari plugin, tema, memori PHP, hingga versi PHP, beserta cara menemukan pelakunya tanpa menebak.

Terbit 5 menit baca

Jawaban singkat

Layar putih kosong di WordPress hampir selalu berasal dari error fatal PHP yang tidak ditampilkan, biasanya dipicu plugin, tema, batas memori, atau versi PHP yang tidak cocok. Cari pesan error di log, lalu nonaktifkan plugin atau tema lewat File Manager bila dasbor tidak bisa dibuka.

Daftar isi
  1. Kenapa layarnya putih, bukan pesan error?
  2. Penyebab yang paling sering
  3. Plugin yang bentrok atau rusak
  4. Tema yang bermasalah
  5. Memori PHP habis
  6. Versi PHP tidak cocok
  7. Cache yang menyimpan halaman kosong
  8. Tabel diagnosis cepat
  9. Cara menemukan pelakunya tanpa menebak
  10. Menonaktifkan plugin tanpa dasbor
  11. Kapan memperbaiki sendiri, kapan memulihkan backup?
  12. Pertanyaan yang sering diajukan

Layar putih kosong, sering dijuluki White Screen of Death, adalah kondisi saat situs WordPress tidak menampilkan apa pun: tanpa teks, tanpa pesan error, hanya halaman putih. Di baliknya hampir selalu ada error fatal PHP yang menghentikan WordPress, sementara server diatur untuk tidak menampilkan pesan error ke pengunjung.

Yang dipertaruhkan di sini bukan cuma tampilan. Menebak-nebak penyebab lalu menghapus plugin atau mengganti tema sembarangan bisa merusak pengaturan dan data. Langkah yang benar adalah menemukan pesan error-nya dulu, baru memperbaiki bagian yang memang bermasalah.

Kenapa layarnya putih, bukan pesan error?

Saat PHP menemui error fatal, eksekusi berhenti. Kalau pengaturan display_errors di server mati (yang memang disarankan untuk situs produksi), pesan error tidak dikirim ke browser. Hasilnya halaman kosong.

Sejak WordPress 5.2 ada fitur perlindungan error fatal. Pada banyak kasus, kamu tidak lagi melihat layar putih, melainkan pesan "There has been a critical error on this website", dan WordPress mengirim email ke alamat admin berisi tautan recovery mode untuk masuk dasbor dan menonaktifkan plugin atau tema penyebabnya. Layar putih murni masih bisa terjadi bila error terjadi sebelum fitur itu sempat berjalan, misalnya salah ketik di wp-config.php, atau ketika email admin tidak terkirim.

Penyebab yang paling sering

Plugin yang bentrok atau rusak

Ini penyebab nomor satu. Plugin yang baru diperbarui bisa memanggil fungsi yang belum ada di versi PHP server, atau bentrok dengan plugin lain. Tandanya, layar putih muncul tepat setelah memasang atau memperbarui plugin.

Tema yang bermasalah

Kesalahan di functions.php tema, misalnya setelah menempel potongan kode dari internet, langsung menghentikan seluruh situs. Tema lama yang tidak lagi diperbarui juga bisa gagal di versi PHP baru.

Memori PHP habis

Situs dengan banyak plugin, page builder berat, atau proses impor besar bisa melewati batas memori PHP. Pesan di log biasanya berbunyi "Allowed memory size of ... bytes exhausted".

Versi PHP tidak cocok

Menaikkan versi PHP tanpa memeriksa kompatibilitas sering memicu error di plugin lama. Sebaliknya, WordPress dan plugin versi baru membutuhkan versi PHP minimal tertentu. Cek syarat terbarunya di halaman kebutuhan resmi WordPress, dan baca cara mengganti versi PHP di hosting dengan aman sebelum mengubahnya.

Cache yang menyimpan halaman kosong

Plugin cache atau CDN kadang menyimpan halaman kosong saat error terjadi, lalu terus menyajikannya meski masalah sudah diperbaiki. Bersihkan cache setelah setiap perbaikan.

Tabel diagnosis cepat

GejalaPenyebab paling mungkinLangkah pertama
Putih setelah update atau pasang pluginPluginGanti nama folder plugin itu
Putih setelah edit functions.php atau ganti temaTemaKembalikan kode atau ganti nama folder tema
Log menyebut "Allowed memory size"Memori PHP habisNaikkan memory_limit atau WP_MEMORY_LIMIT
Putih setelah ganti versi PHPKompatibilitas PHPKembalikan versi PHP sebelumnya
Hanya dasbor admin yang putihPlugin khusus admin atau memoriCek log, nonaktifkan plugin
Sudah diperbaiki tapi tetap putihCacheBersihkan cache plugin, server, dan CDN

Cara menemukan pelakunya tanpa menebak

Langkah pertama selalu mencari pesan error. Di hosting cPanel, buka menu Errors atau file error_log di folder situs. Caranya dibahas di cara membaca error log di cPanel. Pesan error biasanya menyebut path file, misalnya wp-content/plugins/nama-plugin/..., dan dari situ pelakunya langsung terlihat.

Kalau log tidak tersedia, aktifkan pencatatan error WordPress di wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Error akan tercatat di wp-content/debug.log tanpa tampil ke pengunjung. Penjelasan lengkap ada di cara mengaktifkan debug mode WordPress. Kembalikan WP_DEBUG ke false setelah selesai.

Menonaktifkan plugin tanpa dasbor

Buka File Manager atau SFTP, masuk ke wp-content, lalu ganti nama folder plugins menjadi plugins-off. WordPress akan menganggap semua plugin nonaktif. Kalau situs kembali normal, kembalikan nama folder, lalu ganti nama folder plugin satu per satu sampai pelakunya ketemu.

Untuk tema, ganti nama folder tema aktif di wp-content/themes. WordPress akan beralih ke tema bawaan lain yang terpasang, misalnya salah satu tema Twenty.

Kapan memperbaiki sendiri, kapan memulihkan backup?

Perbaiki sendiri bila log jelas menunjuk satu plugin atau tema dan situs kembali normal setelah bagian itu dinonaktifkan. Kamu tinggal menunggu pembaruan dari pengembang, mencari pengganti, atau mengembalikan versi plugin sebelumnya.

Pulihkan backup bila penyebabnya tidak jelas, banyak file inti yang berubah, atau ada tanda situs disusupi, misalnya file PHP asing di folder uploads. Backup yang dibuat sebelum masalah muncul adalah jalan tercepat untuk kembali online, setelah itu penyebabnya bisa diselidiki di salinan situs.

Mencegah tetap lebih murah daripada memperbaiki. Uji pembaruan di situs staging bila memungkinkan, perbarui plugin satu per satu, dan simpan backup terbaru sebelum setiap pembaruan besar. Tips lengkapnya ada di cara update WordPress tanpa error.

Pertanyaan yang sering diajukan

Apakah layar putih berarti website saya diretas?

Tidak selalu. Penyebab paling umum adalah plugin, tema, atau memori PHP. Namun bila muncul file asing atau kode aneh di file inti, periksa kemungkinan malware.

Saya tidak menerima email recovery mode, apa yang harus dilakukan?

Cek folder spam alamat email admin. Bila tetap tidak ada, nonaktifkan plugin lewat File Manager dengan mengganti nama folder seperti dijelaskan di atas.

Berapa batas memori yang wajar untuk WordPress?

Tergantung situsnya. Situs sederhana cukup dengan batas bawaan hosting, sedangkan toko online dengan banyak plugin butuh lebih besar. Batas di wp-config.php tidak bisa melebihi batas yang diizinkan server.

Kenapa hanya halaman tertentu yang putih?

Biasanya karena shortcode atau blok dari plugin tertentu hanya dipakai di halaman itu. Cek log saat membuka halaman tersebut untuk melihat file yang memicu error.

Sumber & referensi

Baca juga