Layar Putih dan Error Umum WordPress: Cara Membaca debug.log

Sketsa langkah mengaktifkan WP_DEBUG_LOG di wp-config.php lalu membaca berkas debug.log untuk menemukan penyebab error

Written by

in

Ringkasan Cepat
  • Layar putih di WordPress dapat diatasi dengan menyalakan mode debug pada berkas konfigurasi untuk melihat catatan kesalahan.
  • Pemeriksaan baris terakhir pada catatan tersebut membantu menemukan plugin, tema, atau kode bermasalah yang harus dinonaktifkan.
  • Jika kendala teknis tersebut terlalu rumit untuk diselesaikan sendiri, Ari Digital Creative siap membantu mengembalikan fungsi normal situs web Anda.

Layar putih tanpa pesan apa pun membuat panik, padahal WordPress sebenarnya mencatat apa yang salah, asal kita menyuruhnya menulis catatan. Berkas catatan itu bernama debug.log, dan membacanya jauh lebih mudah daripada yang dibayangkan.

Sketsa langkah mengaktifkan WP_DEBUG_LOG di wp-config.php lalu membaca berkas debug.log untuk menemukan penyebab error

Langkah 1: nyalakan pencatatan

Buka wp-config.php lewat File Manager atau FTP. Cari baris yang berbunyi That’s all, stop editing!, lalu tambahkan kode berikut di atasnya:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
  • WP_DEBUG menyalakan mode debug.
  • WP_DEBUG_LOG menulis error ke berkas wp-content/debug.log.
  • WP_DEBUG_DISPLAY bernilai false agar pesan error tidak tampil di depan pengunjung.

Langkah 2: ulangi masalahnya

Muat ulang halaman yang bermasalah supaya error tercatat. Lalu buka wp-content/debug.log dan lihat baris-baris paling bawah, karena itulah yang terbaru.

Langkah 3: baca barisnya

Contoh isi catatan:

[05-Nov-2026 10:15:02 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function fungsi_x()
in /home/situs/public_html/wp-content/plugins/plugin-x/fungsi.php:42

Tiga hal yang perlu dicari:

  1. Jenis error. Fatal error menghentikan halaman. Warning dan Notice biasanya tidak menghentikan apa pun.
  2. Jalur berkas. Di contoh, bagian plugins/plugin-x/ menunjukkan penyebabnya adalah plugin bernama plugin-x. Bila jalurnya memuat themes/, penyebabnya tema.
  3. Nomor baris (di sini 42) membantu pembuat plugin atau tema menemukan kodenya.

Langkah 4: singkirkan penyebabnya

Bila penyebabnya plugin dan Anda tidak bisa masuk dasbor, ganti nama folder plugin itu di wp-content/plugins/ (misalnya jadi plugin-x-mati). WordPress otomatis menonaktifkannya. Untuk tema, ganti nama folder tema aktif sehingga WordPress kembali ke tema bawaan.

Baca juga Child Theme dan Cara Aman Menambah Kode di WordPress

WordPress juga punya mode pemulihan: saat terjadi error fatal, email berisi tautan khusus dikirim ke alamat admin supaya Anda bisa masuk dan menonaktifkan plugin atau tema bermasalah.

Penyebab yang paling sering

Gejala di catatan Biasanya berarti
Allowed memory size exhausted Batas memori PHP terlalu kecil atau ada plugin boros. Coba naikkan WP_MEMORY_LIMIT atau minta hosting menaikkan batas.
Call to undefined function Plugin atau tema bentrok, atau versi PHP tidak cocok.
Parse error / syntax error Salah ketik pada kode yang baru ditambahkan.
Error establishing a database connection Data di wp-config.php (nama, pengguna, sandi database) keliru, atau server database mati.

Penting: matikan lagi setelah selesai

Berkas debug.log bisa memuat jalur server dan informasi lain yang tidak boleh dilihat orang luar, dan pada banyak hosting alamatnya bisa diakses langsung. Setelah masalah beres:

  • Ubah WP_DEBUG menjadi false (atau hapus ketiga baris tadi).
  • Hapus berkas debug.log.

Kalau Anda sering membutuhkannya, minta hosting memblokir akses langsung ke berkas itu.

Bila catatannya terlalu teknis, kirim baris Fatal error saja (tanpa data pribadi) ke dukungan hosting atau pembuat plugin. Baris itu biasanya cukup bagi mereka untuk menemukan sumber masalah.

Pertanyaan yang Sering Diajukan

Apa penyebab utama munculnya layar putih kosong pada situs WordPress?

Layar putih kosong biasanya terjadi karena error fatal pada kode PHP, plugin yang tidak kompatibel, atau batas memori server yang terlampaui. Situs berhenti menampilkan halaman karena proses eksekusi terhenti di tengah jalan tanpa pesan visual.

Bagaimana cara melihat pesan error di balik layar putih tersebut?

Anda perlu mengaktifkan mode pencatatan error melalui berkas konfigurasi situs pengaturan sistem utama untuk merekam setiap kendala teknis yang terjadi ke dalam berkas log khusus secara tersembunyi.

Bagaimana cara mengatasi error jika saya tidak bisa masuk ke dalam halaman dasbor?

Anda bisa mengakses direktori penyimpanan situs melalui pengelola berkas di panel hosting, lalu mengubah nama folder plugin atau tema yang bermasalah agar sistem menonaktifkannya secara otomatis dari luar.

Apakah pencatatan error harus selalu dinyalakan terus-menerus?

Tidak, mode pencatatan harus dimatikan kembali setelah masalah selesai agar informasi jalur server tidak terekspos. Jika kendala terus berlanjut, Ari Digital Creative siap membantu menangani masalah teknis situs Anda dengan cepat dan transparan.

Apa yang harus dilakukan jika isi berkas catatan error terlalu sulit dipahami?

Cukup salin bagian baris yang menunjukkan jenis error fatal dan lokasi berkasnya, lalu kirimkan informasi tersebut kepada tim dukungan teknis hosting atau pengembang plugin terkait untuk diperiksa lebih lanjut.