Panduan Mengatasi White Screen of Death (WSOD) Layar Putih pada WordPress

Gejala & Penyebab White Screen of Death (WSOD) pada WordPress

Fenomena White Screen of Death (WSOD) atau tampilan layar putih polos tanpa pesan eror pada website WordPress menandakan terjadinya PHP Fatal Error saat halaman diproses, namun fitur pelaporan kesalahan (error reporting) pada server dalam kondisi dinonaktifkan demi alasan keamanan.

Berikut 4 penyebab teknis paling umum terjadinya WSOD pada WordPress:

• Kehabisan Batas Memori PHP (PHP Memory Exhausted): Skrip WordPress atau plugin membutuhkan memori lebih besar dari alokasi memory_limit server.
• Konflik Plugin / Tema Tidak Kompatibel: Pembaruan plugin atau kode fungsi functions.php mengalami bentrokan sintaks atau inkompatibilitas versi PHP.
• File Core WordPress Corrupt: Berkas bawaan WordPress pada direktori wp-includes atau wp-admin mengalami kerusakan saat proses auto-update.
• Database Overhead & Crashed Table: Tabel database mengalami kerusakan atau koneksi database terputus di tengah jalan.

“Penanganan WSOD yang benar tidak dilakukan dengan menebak-nebak, melainkan dengan mengaktifkan mode WP_DEBUG untuk memunculkan pesan error teknis yang spesifik.” — Tim Tech Support AN Media Jember

Langkah 1: Aktifkan Mode Debug WordPress (WP_DEBUG)

Untuk mengetahui penyebab pasti dibalik layar putih, buka file wp-config.php melalui SSH, cPanel File Manager, atau FTP:

# Masuk ke direktori WordPress
cd /var/www/html/wordpress

# Edit berkas wp-config.php
nano wp-config.php

Cari baris define('WP_DEBUG', false); dan ganti dengan blok kode debug berikut:

// Aktifkan pencatatan error ke file debug.log
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

Setelah disimpan, refresh halaman website yang mengalami WSOD. WordPress akan secara otomatis mencatat rincian kesalahan teknis ke dalam berkas wp-content/debug.log.

Langkah 2: Inspeksi Berkas Log Kesalahan debug.log

Jalankan perintah berikut pada terminal server Anda untuk membaca baris error terbaru:

tail -f -n 30 wp-content/debug.log

Pesan error akan menunjukkan nama file dan baris spesifik yang rusak, contohnya:
PHP Fatal Error: Uncaught Error: Call to undefined function... in /wp-content/plugins/nama-plugin/plugin.php on line 42

Langkah 3: Naikkan Batas Memori PHP (PHP Memory Limit)

Jika log menunjukkan error kehabisan memori (Allowed memory size of xxx bytes exhausted), tambahkan aturan alokasi memori pada wp-config.php tepat sebelum baris /* That's all, stop editing! Happy publishing. */:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Langkah 4: Nonaktifkan Plugin Bermasalah via WP-CLI atau Terminal

Jika WSOD disebabkan oleh plugin, nonaktifkan seluruh plugin secara instan menggunakan WP-CLI:

wp plugin deactivate --all --path=/var/www/html/wordpress

Atau secara manual ubah nama direktori plugin melalui terminal:

cd wp-content
mv plugins plugins_old
mkdir plugins

Jika website kembali normal, aktifkan kembali plugin satu per satu untuk mengisolasi plugin mana yang memicu masalah.

Langkah 5: Kembalikan Tema ke Tema Bawaan WordPress (Default Theme)

Jika kesalahan berasal dari file functions.php tema, ganti tema aktif ke tema standar (seperti Twenty Twenty-Four) via WP-CLI:

wp theme activate twentytwentyfour

Langkah 6: Re-install Berkas Core WordPress Tanpa Menghapus Konten

Jika WSOD dipicu oleh berkas core yang rusak, lakukan instalasi ulang berkas WordPress core menggunakan WP-CLI:

wp core download --skip-content --force

Perintah ini secara aman memperbarui direktori wp-admin dan wp-includes tanpa mengganggu isi folder wp-content maupun database Anda.

Rangkuman Checklist Pemecahan Masalah WSOD WordPress

• Aktifkan WP_DEBUG dan WP_DEBUG_LOG pada wp-config.php.
• Baca pesan error spesifik pada file wp-content/debug.log.
• Naikkan limit memori ke 256M via WP_MEMORY_LIMIT.
• Deaktivasi plugin via WP-CLI (wp plugin deactivate --all).
• Beralih ke tema default atau install ulang core WordPress.

Kesimpulan & Layanan Web Maintenance AN Media

Menangani masalah White Screen of Death (WSOD) pada WordPress secara terstruktur memangkas waktu downtime bisnis Anda. Jika Anda membutuhkan Jasa Perbaikan Website WordPress & Tuning Server di Jember, tim profesional AN Media siap membantu 24/7.