Panduan Lengkap Mengatasi Error WordPress Langkah Demi Langkah

Kalau website tiba-tiba blank putih, muncul 500 Internal Server Error, gagal unggah gambar, atau menampilkan pesan “There has been a critical error on this website”, rasanya memang bikin deg-degan. Kabar baiknya, sebagian besar error di WordPress bisa dilacak dengan langkah yang rapi: mulai dari backup, membaca log, menonaktifkan plugin, mengecek tema, sampai memperbaiki konfigurasi server.

Ringkasnya: panduan ini membahas cara mengatasi error di WordPress secara bertahap, lengkap dengan persiapan, perintah teknis, contoh kode, hasil yang diharapkan, perbandingan metode, studi kasus, dan tips troubleshooting. Cocok buat Teman-Teman yang mengelola blog pribadi, toko online WooCommerce, website sekolah, portal berita lokal, landing page bisnis, atau situs jasa di Jakarta, Bandung, Surabaya, Yogyakarta, Medan, Denpasar, dan kota lain di Indonesia.

Jawaban cepat: Untuk mengatasi error WordPress, mulai dari backup website, aktifkan mode debug, cek log error, nonaktifkan plugin dan tema, periksa file .htaccess, naikkan limit PHP bila perlu, cek koneksi database, lalu hubungi penyedia hosting jika masalah berasal dari server.

Getting Started: Pahami Dulu Cara Kerja Error WordPress

Sebelum masuk ke langkah teknis, kita samakan dulu gambaran besarnya.

WordPress itu ibarat warung digital. Ada etalase depan yang dilihat pengunjung, ada dapur belakang berupa dashboard admin, ada gudang database, ada rak file berisi tema dan plugin, lalu ada listriknya yaitu server hosting.

Kalau website error, penyebabnya bisa datang dari salah satu bagian ini:

• Plugin yang bentrok atau rusak
• Tema yang tidak cocok dengan versi WordPress atau PHP
• Database yang tidak bisa tersambung
• File WordPress yang rusak
• Server hosting yang kehabisan memori atau waktu eksekusi
• File .htaccess yang salah aturan
• Cache browser, plugin, atau CDN yang menyimpan tampilan lama
• DNS atau firewall yang memblokir koneksi ke layanan WordPress

MUGHU sering melihat satu pola yang sama saat menangani website WordPress: orang panik lalu langsung mengubah banyak hal sekaligus. Ini bahaya. Kalau lima perubahan dijalankan bersamaan, kita jadi tidak tahu solusi mana yang berhasil atau malah bikin masalah baru.

Jadi, prinsip utama memperbaiki error WordPress adalah:

1. Amankan data dulu.
2. Cari petunjuk error.
3. Uji satu penyebab dalam satu waktu.
4. Catat perubahan.
5. Pulihkan akses website secepat mungkin.

Prasyarat Sebelum Mengatasi Error di WordPress

Sebelum utak-atik file, pastikan Teman-Teman punya akses dan alat berikut.

Akses yang sebaiknya disiapkan

• Akses dashboard WordPress
• Akses cPanel, Plesk, hPanel, DirectAdmin, atau panel hosting lain
• Akses File Manager hosting
• Akses FTP/SFTP memakai FileZilla atau aplikasi sejenis
• Akses phpMyAdmin untuk database
• Akses SSH kalau memakai VPS atau cloud server
• Email admin WordPress, terutama untuk kasus critical error
• Backup terbaru file dan database

Alat yang berguna

Kenapa backup wajib?

Backup itu sabuk pengaman. Kita berharap tidak dipakai, tapi saat terjadi masalah, backup bisa menyelamatkan semuanya.

Backup yang ideal mencakup:

• Folder WordPress, terutama wp-content
• Database MySQL atau MariaDB
• File konfigurasi seperti wp-config.php
• File .htaccess
• Upload media di wp-content/uploads

Kalau website dipakai untuk bisnis, backup bukan cuma urusan teknis. Ini soal biaya downtime, kehilangan pesanan, prospek masuk, trafik SEO, tampilan iklan, sampai kepercayaan pelanggan.

Perbandingan Metode Mengatasi Error WordPress

Sebelum memilih langkah, lihat dulu metode mana yang paling cocok.

Rekomendasi berdasarkan situasi

Step 1: Backup Website Sebelum Menyentuh Apa Pun

Langkah pertama mengatasi error di WordPress adalah membuat backup. Jangan lewati bagian ini walau kelihatannya error-nya kecil.

Kalau Teman-Teman masih bisa masuk dashboard, gunakan plugin backup yang sudah tersedia. Kalau tidak bisa masuk admin, pakai panel hosting.

Backup lewat cPanel atau panel hosting

Biasanya alurnya seperti ini:

1. Masuk ke panel hosting.
2. Buka menu Backup, Backup Wizard, atau fitur sejenis.
3. Unduh backup file website.
4. Unduh backup database.
5. Simpan di komputer atau penyimpanan awan.

Backup manual lewat SSH

Kalau memakai VPS, Teman-Teman bisa membuat arsip file website dengan perintah:

cd /var/www/html
tar -czvf backup-wordpress-files.tar.gz .

Lalu backup database:

mysqldump -u nama_user_database -p nama_database > backup-wordpress-database.sql

Masukkan kata sandi database saat diminta.

Expected output

Untuk backup file:

backup-wordpress-files.tar.gz

Untuk backup database:

Baca juga Netlify: Panduan Lengkap Deploy Website Tanpa Ribet

backup-wordpress-database.sql

Kenapa langkah ini penting?

Karena banyak perbaikan WordPress melibatkan perubahan file dan database. Kalau salah edit wp-config.php, salah hapus folder plugin, atau salah ubah tabel database, backup membuat kita bisa mundur ke kondisi aman.

Step 2: Kenali Jenis Error yang Muncul

Setiap pesan error memberi petunjuk. Jangan cuma melihat website “rusak”, tapi baca pesan yang muncul.

Jenis error WordPress yang sering muncul

Kenapa identifikasi error penting?

Karena solusi untuk tiap error berbeda. Error 404 biasanya tidak perlu bongkar database. Error database tidak selesai hanya dengan membersihkan cache. Error 500 bisa terlihat umum, tapi penyebabnya bisa dari file .htaccess, plugin, tema, atau limit server.

Kalau ibarat dokter, langkah ini seperti memeriksa gejala sebelum memberi obat.

Step 3: Aktifkan Mode Debug WordPress

Mode debug membantu WordPress menampilkan atau mencatat pesan error yang lebih jelas. Ini sangat berguna untuk critical error, blank putih, dan error PHP.

Dokumentasi resmi WordPress juga menjelaskan konstanta debug seperti WP_DEBUG, WP_DEBUG_LOG, dan WP_DEBUG_DISPLAY di halaman Debugging in WordPress.

Cara mengaktifkan debug

Buka file wp-config.php di folder utama WordPress. Biasanya lokasinya sejajar dengan folder:

wp-admin
wp-content
wp-includes

Cari baris ini:

define( 'WP_DEBUG', false );

Ubah atau tambahkan konfigurasi berikut sebelum baris:

/* That's all, stop editing! Happy publishing. */

Kode lengkapnya:

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

Kenapa WP_DEBUG_DISPLAY dibuat false?

Karena kita tidak ingin pesan error tampil ke pengunjung. Lebih aman kalau error dicatat ke file log.

Dengan pengaturan di atas, error biasanya tersimpan di:

wp-content/debug.log

Expected output

Setelah membuka atau memuat ulang website, cek file:

wp-content/debug.log

Contoh isi log:

PHP Fatal error: Uncaught Error: Call to undefined function example_function()
in /home/user/public_html/wp-content/plugins/nama-plugin/plugin.php:42

Dari contoh ini, petunjuknya jelas:

• Error berasal dari plugin
• Nama file bermasalah terlihat
• Nomor baris kode terlihat

Setelah selesai, matikan debug

Jangan biarkan debug aktif terus di website produksi.

Ubah kembali menjadi:

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

Step 4: Cek Log Error Server

Kalau debug WordPress belum cukup, cek log server. Ini sering membantu untuk error 500, timeout, masalah permission, atau batas memori.

Lokasi log yang umum

Di cPanel, biasanya ada menu:

Metrics > Errors

Di VPS berbasis Ubuntu dengan Apache, log bisa ada di:

Baca juga Tutorial Cloudflare Tunnel: Aplikasi Lokal ke Internet

/var/log/apache2/error.log

Untuk Nginx:

/var/log/nginx/error.log

Perintah membaca log Apache

tail -n 100 /var/log/apache2/error.log

Perintah membaca log Nginx

tail -n 100 /var/log/nginx/error.log

Expected output

PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

Artinya, website kehabisan memori PHP.

Contoh lain:

Permission denied: /wp-content/uploads/2026/07/image.jpg

Artinya, folder upload kemungkinan bermasalah di izin file.

Kenapa log server penting?

Log server seperti rekaman CCTV. Website hanya menampilkan “error”, tapi log bisa menunjukkan kejadian sebenarnya di belakang layar.

Step 5: Nonaktifkan Semua Plugin WordPress

Plugin adalah penyebab yang sangat sering muncul dalam error WordPress. Bukan berarti plugin itu buruk, ya. Masalah biasanya muncul karena:

• Plugin tidak cocok dengan versi WordPress terbaru
• Plugin bentrok dengan plugin lain
• Plugin tidak cocok dengan versi PHP
• Plugin rusak saat proses update
• Plugin terlalu berat untuk server

Kalau masih bisa masuk dashboard

Ikuti langkah ini:

1. Masuk ke Plugins > Installed Plugins.
2. Pilih semua plugin.
3. Pilih Deactivate.
4. Cek website.
5. Aktifkan plugin satu per satu.
6. Setiap mengaktifkan satu plugin, muat ulang website.

Kalau tidak bisa masuk dashboard

Gunakan File Manager atau FTP.

Masuk ke folder:

wp-content

Ubah nama folder:

plugins

Menjadi:

plugins_old

Expected output

Jika penyebabnya plugin, website akan kembali terbuka setelah folder plugin diubah namanya.

Setelah itu, buat folder baru bernama:

plugins

Lalu pindahkan plugin dari plugins_old satu per satu untuk mencari penyebabnya.

Alternatif lewat WP-CLI

Kalau punya akses SSH dan WP-CLI, jalankan:

wp plugin deactivate --all

Expected output:

Success: Deactivated 12 of 12 plugins.

Untuk mengaktifkan satu plugin:

wp plugin activate nama-plugin

Kenapa langkah ini penting?

Karena plugin berjalan di atas WordPress. Kalau ada satu plugin memicu fatal error, seluruh website bisa ikut tumbang. Dengan menonaktifkan semua plugin, kita memisahkan masalah plugin dari masalah inti WordPress.

Step 6: Ganti Tema ke Tema Bawaan WordPress

Kalau plugin bukan penyebabnya, cek tema. Tema WordPress tidak cuma mengatur tampilan, tapi juga bisa berisi fungsi PHP, integrasi editor, script, dan pengaturan tambahan.

Tema yang rusak bisa memicu:

Baca juga Panduan Lengkap Notion AI 2026

• Blank putih
• Critical error
• Layout berantakan
• Menu tidak berfungsi
• Error setelah update PHP
• Error setelah update WordPress

Cara lewat dashboard

1. Masuk ke Appearance > Themes.
2. Aktifkan tema bawaan seperti Twenty Twenty-Four atau Twenty Twenty-Five.
3. Cek website.

Cara lewat File Manager atau FTP

Masuk ke folder:

wp-content/themes

Cari folder tema aktif. Misalnya:

tema-bisnis

Ubah menjadi:

tema-bisnis_old

WordPress biasanya akan mencoba memakai tema bawaan yang tersedia.

Cara lewat WP-CLI

Lihat daftar tema:

wp theme list

Aktifkan tema bawaan:

wp theme activate twentytwentyfour

Expected output:

Success: Switched to 'Twenty Twenty-Four' theme.

Kenapa tema perlu dicek?

Banyak orang mengira tema hanya soal warna dan tata letak. Padahal tema bisa berisi kode PHP aktif. Kalau kode itu tidak cocok dengan versi PHP server, error bisa muncul bahkan sebelum halaman selesai dimuat.

Step 7: Perbaiki File .htaccess untuk Error 500 dan 404

File .htaccess adalah file konfigurasi server Apache. Di WordPress, file ini sering mengatur permalink atau struktur URL.

Kalau file ini rusak, website bisa memunculkan:

• 500 Internal Server Error
• 404 Not Found
• Redirect berulang
• Halaman admin tidak bisa dibuka

Cara cepat memperbaiki .htaccess

Masuk ke folder utama WordPress, lalu cari file:

.htaccess

Ubah namanya menjadi:

.htaccess_old

Lalu coba buka website.

Kalau website terbuka, berarti file .htaccess lama bermasalah.

Buat .htaccess baru

Kalau masih bisa masuk dashboard:

1. Buka Settings > Permalinks.
2. Jangan ubah apa pun.
3. Klik Save Changes.

WordPress akan membuat ulang aturan permalink.

Isi .htaccess standar WordPress

Kalau perlu membuat manual, gunakan:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Expected output

• Error 500 hilang jika penyebabnya .htaccess
• Halaman dan artikel kembali bisa dibuka
• Error 404 akibat permalink rusak berkurang

Kenapa langkah ini penting?

WordPress mengandalkan aturan rewrite agar URL cantik seperti:

https://domain.com/cara-mengatasi-error-wordpress/

bisa diarahkan ke konten yang benar. Kalau aturan rewrite rusak, server tidak tahu halaman mana yang harus ditampilkan.

Step 8: Atasi 500 Internal Server Error

500 Internal Server Error adalah salah satu error paling membingungkan, karena pesannya umum banget. Server hanya memberi tahu bahwa ada sesuatu yang salah, tapi tidak langsung menunjukkan penyebabnya.

Baca juga Cara Migrasi WordPress ke VPS Tanpa Downtime

Penyebab umum error 500

• File .htaccess rusak
• Plugin bentrok
• Tema bermasalah
• Limit memori PHP habis
• File inti WordPress rusak
• Permission file salah
• Versi PHP tidak cocok

Urutan perbaikan yang disarankan

1. Rename .htaccess.
2. Nonaktifkan semua plugin.
3. Ganti tema ke tema bawaan.
4. Aktifkan debug.
5. Cek log server.
6. Naikkan memory limit.
7. Upload ulang folder wp-admin dan wp-includes.

Naikkan memory limit lewat wp-config.php

Tambahkan sebelum baris “stop editing”:

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

Naikkan memory limit lewat php.ini

memory_limit = 256M
max_execution_time = 300

Naikkan memory limit lewat .htaccess

php_value memory_limit 256M
php_value max_execution_time 300

Catatan kecil: tidak semua hosting mengizinkan pengaturan PHP lewat .htaccess. Kalau setelah menambah kode ini website malah error 500, hapus kode tersebut dan atur lewat panel hosting.

Upload ulang file inti WordPress

Kalau plugin dan tema tidak menyelesaikan masalah, ada kemungkinan file inti WordPress rusak.

Unduh WordPress dari situs resmi WordPress.org, lalu upload ulang folder:

wp-admin
wp-includes

Jangan timpa folder:

wp-content

karena folder itu berisi tema, plugin, dan media website.

Expected output

Website kembali memuat halaman normal, atau minimal pesan error berubah menjadi lebih spesifik sehingga lebih mudah dilacak.

Step 9: Atasi White Screen of Death atau Layar Putih

White Screen of Death, sering disingkat WSoD, adalah kondisi ketika website hanya menampilkan layar putih kosong. Tidak ada pesan. Tidak ada petunjuk. Bikin garuk-garuk kepala.

Penyebab paling sering

• Plugin fatal error
• Tema rusak
• PHP memory limit habis
• Kesalahan kode di functions.php
• Update gagal
• Versi PHP tidak cocok

Langkah perbaikan

1. Aktifkan debug WordPress.
2. Rename folder plugins.
3. Rename folder tema aktif.
4. Naikkan limit memori PHP.
5. Cek file debug.log.
6. Restore backup jika error muncul setelah update besar.

Contoh error di debug.log

PHP Parse error: syntax error, unexpected token "}" in /wp-content/themes/tema-aktif/functions.php on line 87

Artinya ada kesalahan kode di file functions.php, baris 87.

Cara memperbaiki syntax error sederhana

Misalnya sebelumnya ada kode seperti ini:

function contoh_error() {
    echo 'Halo WordPress';
}}

Ada kelebihan kurung kurawal }.

Perbaiki menjadi:

function contoh_error() {
    echo 'Halo WordPress';
}

Expected output

Setelah kesalahan kode diperbaiki, website tidak lagi blank putih dan halaman mulai tampil normal.

Kenapa WSoD perlu ditangani cepat?

Karena pengunjung tidak mendapat pesan apa pun. Dari sisi pengalaman pengguna, blank putih terasa seperti website mati total. Untuk bisnis lokal, toko online, atau website jasa, ini bisa langsung menurunkan kepercayaan calon pelanggan.

Step 10: Atasi “There Has Been a Critical Error on This Website”

Pesan critical error WordPress biasanya muncul karena fatal error pada PHP. WordPress sering mengirim email ke admin yang berisi informasi penyebab error dan tautan mode pemulihan.

Langkah pertama: cek email admin

Cari email dengan subjek sejenis:

Your Site is Experiencing a Technical Issue

Cek juga folder spam atau promosi.

Email biasanya memberi tahu:

• Plugin atau tema yang bermasalah
• File penyebab error
• Baris kode yang memicu masalah
• Tautan mode pemulihan

Kalau tidak ada email

Jalankan langkah ini:

1. Aktifkan debug.
2. Cek wp-content/debug.log.
3. Nonaktifkan semua plugin.
4. Ganti tema.
5. Cek versi PHP.
6. Naikkan memory limit.

Contoh debug critical error

PHP Fatal error: Uncaught Error: Class "Elementor\Plugin" not found
in /wp-content/plugins/plugin-addon/addon.php:25

Artinya plugin addon memanggil class dari Elementor, tapi Elementor tidak aktif atau tidak tersedia.

Baca juga Rekomendasi Plugin AI untuk Artikel WordPress Otomatis

Solusi

• Aktifkan plugin utama yang dibutuhkan
• Update plugin addon
• Hapus plugin addon kalau tidak kompatibel
• Turunkan versi plugin bila error muncul setelah update

Kenapa critical error sering muncul setelah update?

Karena update mengubah kode. Kalau plugin A bergantung pada fungsi lama dari plugin B, lalu plugin B berubah, plugin A bisa error. Ini sebabnya website bisnis sebaiknya menguji update di staging sebelum diterapkan di website utama.

Step 11: Atasi Error Establishing a Database Connection

Error ini berarti WordPress gagal tersambung ke database. Tanpa database, WordPress tidak bisa mengambil konten, pengaturan, akun pengguna, pesanan WooCommerce, atau data formulir.

Penyebab umum

• Nama database salah
• User database salah
• Kata sandi database salah
• Host database salah
• Server database mati
• Database rusak
• Resource hosting penuh

Cek file wp-config.php

Buka file wp-config.php, lalu cek bagian ini:

define( 'DB_NAME', 'nama_database' );
define( 'DB_USER', 'user_database' );
define( 'DB_PASSWORD', 'password_database' );
define( 'DB_HOST', 'localhost' );

Pastikan sesuai dengan data di panel hosting.

Tes koneksi database sederhana

Buat file sementara bernama:

db-test.php

Isi dengan kode:

<?php
$mysqli = new mysqli('localhost', 'user_database', 'password_database', 'nama_database');

if ($mysqli->connect_error) {
    die('Koneksi gagal: ' . $mysqli->connect_error);
}

echo 'Koneksi database berhasil';

Buka di browser:

https://domain.com/db-test.php

Expected output

Kalau berhasil:

Koneksi database berhasil

Kalau gagal:

Koneksi gagal: Access denied for user

Setelah selesai, hapus file db-test.php. Jangan dibiarkan di server.

Perbaiki database lewat fitur WordPress

Tambahkan ini ke wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Lalu buka:

https://domain.com/wp-admin/maint/repair.php

Pilih:

• Repair Database
• atau Repair and Optimize Database

Setelah selesai, hapus baris:

define( 'WP_ALLOW_REPAIR', true );

Kenapa baris itu harus dihapus?

Karena halaman perbaikan database bisa diakses tanpa login saat fitur ini aktif. Untuk keamanan, aktifkan hanya saat dibutuhkan.

Step 12: Atasi Error 404 Not Found di WordPress

Error 404 terjadi ketika halaman tidak ditemukan. Ini bisa terjadi di satu halaman, beberapa artikel, atau seluruh website kecuali beranda.

Penyebab umum

• Permalink rusak
• File .htaccess bermasalah
• Artikel dihapus
• URL berubah
• Plugin redirect salah pengaturan
• Custom post type belum flush rewrite rules

Cara paling cepat: simpan ulang permalink

1. Masuk ke dashboard.
2. Buka Settings > Permalinks.
3. Klik Save Changes.

Tidak perlu mengubah struktur.

Flush rewrite lewat WP-CLI

wp rewrite flush

Expected output:

Success: Rewrite rules flushed.

Kalau hanya beberapa URL yang 404

Cek:

• Apakah halaman masih ada?
• Apakah slug berubah?
• Apakah ada redirect lama?
• Apakah link internal salah?
• Apakah artikel pindah kategori?

Contoh redirect di .htaccess

Kalau halaman lama pindah ke halaman baru:

Baca juga Shortcut Keyboard Excel: Kerja Jadi 50% Lebih Cepat

Redirect 301 /artikel-lama/ https://domain.com/artikel-baru/

Kenapa 404 perlu diperbaiki?

Error 404 memang tidak selalu merusak seluruh website, tapi bisa mengganggu pengalaman pengunjung dan membuang peluang SEO. Kalau halaman lama punya trafik dari Google, redirect 301 membantu mengarahkan pengunjung ke halaman yang relevan.

Step 13: Atasi Gagal Upload Gambar dan Media

Masalah upload gambar sering muncul dengan pesan seperti:

HTTP error

atau:

The uploaded file exceeds the upload_max_filesize directive in php.ini

atau:

Failed to write file to disk

Penyebab umum

• Ukuran file terlalu besar
• Permission folder upload salah
• Folder temporary tidak tersedia
• Memory limit kecil
• Plugin keamanan memblokir upload
• File type tidak diizinkan
• Server kehabisan ruang penyimpanan

Cek permission folder upload

Folder upload ada di:

wp-content/uploads

Permission yang umum:

Lewat SSH:

find wp-content/uploads -type d -exec chmod 755 {} \;
find wp-content/uploads -type f -exec chmod 644 {} \;

Naikkan batas upload lewat php.ini

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300

Naikkan lewat .htaccess

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300

Cek ukuran maksimal dari WordPress

Masuk ke:

Media > Add New

Biasanya WordPress menampilkan batas upload maksimal.

Expected output:

Maximum upload file size: 64 MB.

Kenapa post_max_size harus lebih besar atau sama?

Karena upload file dikirim melalui permintaan POST. Kalau upload_max_filesize 64M tapi post_max_size cuma 8M, upload tetap gagal.

Step 14: Atasi Maximum Execution Time Exceeded

Error ini muncul saat proses PHP berjalan terlalu lama. Biasanya terjadi ketika:

• Import konten besar
• Update plugin berat
• Backup berjalan lama
• Generate thumbnail banyak gambar
• Plugin optimasi memproses banyak file

Contoh pesan error

Fatal error: Maximum execution time of 30 seconds exceeded

Solusi lewat php.ini

max_execution_time = 300
max_input_time = 300

Solusi lewat .htaccess

php_value max_execution_time 300
php_value max_input_time 300

Solusi lewat wp-config.php

set_time_limit(300);

Letakkan dengan hati-hati. Kalau server hosting tidak mengizinkan, kode ini bisa tidak berpengaruh.

Kenapa jangan asal menaikkan terlalu tinggi?

Karena proses yang terlalu lama bisa membebani server. Kalau error terus muncul, akar masalahnya mungkin bukan sekadar waktu eksekusi, tapi plugin terlalu berat, database penuh, atau hosting kurang kuat.

Step 15: Atasi Memory Limit Error

Memory limit error biasanya muncul seperti ini:

Fatal error: Allowed memory size of 134217728 bytes exhausted

Artinya, WordPress membutuhkan memori lebih besar daripada batas yang tersedia.

Solusi lewat wp-config.php

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

Solusi lewat php.ini

memory_limit = 256M

Solusi lewat panel hosting

Cari menu seperti:

PHP Settings
PHP Options
MultiPHP INI Editor
Select PHP Version

Lalu ubah:

memory_limit

menjadi:

256M

atau sesuai batas paket hosting.

Baca juga Rumus dan Fitur Excel: Panduan Lengkap untuk Pemula

Expected output

Error memory limit hilang, dashboard lebih stabil, dan proses seperti update atau upload berjalan normal.

Kapan harus upgrade hosting?

Kalau website sering kehabisan memori walau sudah dinaikkan, berarti ada dua kemungkinan:

• Website terlalu berat
• Paket hosting terlalu kecil

Untuk toko online, portal berita, atau website kursus dengan banyak plugin, upgrade ke paket yang lebih kuat sering lebih efisien daripada terus memadamkan api.

Step 16: Atasi Briefly Unavailable for Scheduled Maintenance

Pesan ini muncul saat WordPress sedang update. Normalnya hilang sendiri setelah update selesai.

Masalah muncul ketika update gagal, lalu website tertahan di mode maintenance.

Gejala

Pengunjung melihat:

Briefly unavailable for scheduled maintenance. Check back in a minute.

Solusi

Masuk ke folder utama WordPress, lalu hapus file:

.maintenance

Lewat SSH:

rm .maintenance

Expected output

Website kembali terbuka.

Kenapa file ini muncul?

Saat update berlangsung, WordPress membuat file .maintenance untuk memberi tahu sistem bahwa website sedang dirawat. Kalau update berhenti di tengah jalan, file ini tidak terhapus otomatis.

Step 17: Atasi “An Unexpected Error Occurred” Saat Tambah Plugin

Error ini sering muncul saat WordPress tidak bisa tersambung ke server WordPress.org. Akibatnya, Teman-Teman bisa gagal:

• Menambah plugin baru
• Mengunduh tema
• Menjalankan update
• Menerbitkan konten yang bergantung pada koneksi eksternal tertentu

Penyebab umum

• DNS server bermasalah
• Firewall memblokir koneksi
• Server tidak bisa menjangkau api.wordpress.org
• Konfigurasi VPS kurang tepat

Tes koneksi ke API WordPress

Jalankan:

curl -I https://api.wordpress.org

Expected output

Kalau normal, hasilnya kurang lebih:

HTTP/2 200
server: nginx
content-type: text/html; charset=utf-8

Tambahkan hosts entry jika DNS bermasalah

Buka file hosts:

sudo nano /etc/hosts

Tambahkan:

198.143.164.251 api.wordpress.org

Simpan file.

Whitelist IP di CSF Firewall

Kalau memakai CSF:

sudo nano /etc/csf/csf.allow

Tambahkan:

198.143.164.251 # WordPress API

Restart CSF:

sudo csf -r

Kenapa ini penting?

WordPress butuh koneksi ke WordPress.org untuk mengambil data plugin, tema, dan update. Kalau koneksi ini terblokir, dashboard bisa terlihat normal, tapi fitur update dan instalasi gagal.

Baca juga Rumus VLOOKUP Excel: Cara Pakai & Contoh Lengkap

Step 18: Atasi “Headers Already Sent”

Error ini biasanya muncul karena ada spasi kosong, karakter tak sengaja, atau output sebelum fungsi header PHP berjalan.

Contoh pesan

Warning: Cannot modify header information - headers already sent by

Penyebab umum

• Ada spasi sebelum <?php
• Ada spasi setelah ?>
• File tersimpan dengan BOM
• Plugin atau tema mengirim output terlalu awal

Contoh kode bermasalah

<?php
function contoh() {
    return true;
}

Ada baris kosong sebelum <?php.

Perbaikan

<?php
function contoh() {
    return true;
}

Untuk file PHP murni, sebaiknya tidak memakai penutup ?> di akhir file.

Kenapa ini penting?

Header HTTP harus dikirim sebelum isi halaman. Kalau PHP sudah mengirim spasi atau teks lebih dulu, header tidak bisa diubah lagi.

Step 19: Atasi Layout Website Berantakan

Kadang website masih bisa dibuka, tapi tampilannya kacau. Menu tidak rapi, slider mati, tombol tidak bisa diklik, atau desain berubah aneh.

Penyebab umum

• Cache menyimpan file lama
• Plugin optimasi menggabungkan CSS/JS secara agresif
• CSS tema tidak termuat
• JavaScript error
• Konten disalin dari dokumen dengan format berantakan
• CDN belum memperbarui file

Langkah perbaikan

1. Bersihkan cache browser.
2. Bersihkan cache plugin WordPress.
3. Matikan fitur minify CSS/JS.
4. Matikan fitur combine CSS/JS.
5. Bersihkan cache CDN.
6. Cek console browser.

Cek error JavaScript di browser

Buka website, lalu tekan:

Ctrl + Shift + J

atau di Mac:

Cmd + Option + J

Cek tab Console.

Contoh error:

Uncaught TypeError: $ is not a function

Ini biasanya terkait konflik JavaScript atau jQuery.

Kenapa fitur optimasi bisa bikin masalah?

Minify dan combine CSS/JS bertujuan mempercepat website. Tapi kalau urutan file berubah, beberapa script bisa berjalan sebelum file yang dibutuhkan siap. Hasilnya, tampilan kacau.

Step 20: Atasi Tidak Bisa Login Dashboard WordPress

Tidak bisa login bisa terjadi karena banyak hal. Jangan langsung reset website.

Penyebab umum

• Salah kata sandi
• Cookie browser bermasalah
• Plugin keamanan memblokir login
• URL WordPress salah
• Redirect berulang
• Database user bermasalah
• File .htaccess mengunci akses

Langkah cepat

1. Coba browser lain.
2. Bersihkan cookie dan cache.
3. Reset kata sandi lewat email.
4. Rename folder plugin keamanan.
5. Rename .htaccess.
6. Cek siteurl dan home di database.

Ubah URL WordPress lewat wp-config.php

Tambahkan:

define( 'WP_HOME', 'https://domain.com' );
define( 'WP_SITEURL', 'https://domain.com' );

Ganti domain.com sesuai domain Teman-Teman.

Ubah password admin lewat WP-CLI

wp user update namauser --user_pass="PasswordBaruYangKuat"

Expected output:

Success: Updated user 1.

Kenapa URL penting?

Kalau WordPress Address dan Site Address tidak sama formatnya, misalnya satu pakai www dan satu lagi tidak, login bisa bermasalah karena cookie tidak cocok.

Step 21: Update Versi PHP dengan Aman

WordPress berjalan di atas PHP. Kalau versi PHP terlalu lama, plugin modern bisa gagal. Kalau PHP terlalu baru sementara tema lama belum mendukung, error juga bisa muncul.

Dokumentasi resmi WordPress menjelaskan kebutuhan teknis terbaru di halaman WordPress Requirements.

Cara cek versi PHP

Di dashboard WordPress:

Tools > Site Health > Info > Server

Atau lewat SSH:

Baca juga Cara Install 9router di Termux Android, Anti Error

php -v

Expected output:

PHP 8.2.12 (cli)

Tips aman sebelum update PHP

• Backup dulu.
• Update WordPress core.
• Update plugin dan tema.
• Cek kompatibilitas plugin penting.
• Uji di staging kalau website bisnis.
• Naikkan versi bertahap, bukan lompat jauh tanpa tes.

Kenapa versi PHP berpengaruh ke ROI?

Versi PHP yang lebih baru biasanya membawa peningkatan kinerja dan keamanan. Website yang lebih cepat bisa membantu pengalaman pengunjung, konversi, dan efisiensi server. Tapi update tanpa tes bisa memicu downtime, jadi tetap perlu rapi.

Step 22: Gunakan WP-CLI untuk Perbaikan Lebih Cepat

WP-CLI adalah alat untuk mengelola WordPress lewat terminal. Dokumentasi resminya tersedia di WP-CLI.org.

Kalau Teman-Teman mengelola banyak website, WP-CLI bisa menghemat banyak waktu.

Cek status WordPress

wp core version

Expected output:

6.6.2

Nonaktifkan semua plugin

wp plugin deactivate --all

Update semua plugin

wp plugin update --all

Cek daftar plugin

wp plugin list

Expected output:

+-------------------+----------+-----------+---------+
| name              | status   | update    | version |
+-------------------+----------+-----------+---------+
| akismet           | active   | none      | 5.3     |
| woocommerce       | inactive | available | 8.9     |
+-------------------+----------+-----------+---------+

Flush permalink

wp rewrite flush

Reinstall file inti WordPress

wp core download --skip-content --force

Kenapa WP-CLI berguna?

Karena saat dashboard lambat atau tidak bisa dibuka, terminal sering tetap bisa bekerja. Untuk teknisi, agensi, atau pengelola website bisnis, ini jauh lebih cepat daripada klik satu per satu.

Step 23: Bersihkan Cache Browser, Plugin, dan CDN

Kadang error sebenarnya sudah selesai, tapi tampilan lama masih muncul karena cache.

Cache itu seperti fotokopi halaman. Tujuannya mempercepat akses. Tapi saat website diperbaiki, cache bisa menyimpan versi lama yang masih error.

Urutan membersihkan cache

1. Cache browser
2. Cache plugin WordPress
3. Cache server hosting
4. Cache CDN
5. Cache DNS lokal jika perlu

Clear DNS cache di Windows

ipconfig /flushdns

Expected output:

Successfully flushed the DNS Resolver Cache.

Clear DNS cache di macOS

sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder

Kenapa cache sering membingungkan?

Karena Teman-Teman mungkin melihat error, sementara orang lain melihat website normal. Atau sebaliknya. Jadi setelah perbaikan, selalu tes dari browser privat, perangkat lain, atau jaringan berbeda.

Step 24: Audit Plugin dan Tema Setelah Website Pulih

Setelah website kembali hidup, jangan langsung lega total. Justru ini waktu yang tepat untuk bersih-bersih.

Audit plugin

Cek:

• Plugin yang tidak dipakai
• Plugin yang lama tidak update
• Plugin dengan fungsi tumpang tindih
• Plugin berat yang memperlambat website
• Plugin dari sumber tidak jelas

Audit tema

Cek:

• Tema aktif masih dikembangkan atau tidak
• Child theme dipakai atau tidak
• Ada modifikasi langsung di tema utama atau tidak
• Kompatibel dengan versi PHP terbaru atau tidak

Kenapa audit penting?

Banyak error WordPress bukan kejadian tunggal. Error sering muncul karena kebiasaan lama: terlalu banyak plugin, jarang update, tidak ada staging, atau semua perubahan langsung dilakukan di website utama.

Studi Kasus: Website Jasa Lokal Mendadak Critical Error Setelah Update

Background

Sebuah website jasa lokal di area Jakarta Selatan memakai WordPress untuk menerima pertanyaan pelanggan lewat formulir kontak. Website ini juga punya beberapa halaman layanan yang sudah masuk Google, seperti “jasa renovasi rumah Jakarta Selatan” dan “kontraktor rumah minimalis”.

Trafiknya tidak besar, tapi bernilai. Dari 300–500 kunjungan organik per bulan, website bisa menghasilkan 20–35 pertanyaan masuk. Jadi, saat website error, dampaknya langsung terasa.

Challenge/Problem

Masalah muncul setelah update plugin formulir dan page builder. Website menampilkan pesan:

There has been a critical error on this website.

Dashboard admin juga tidak bisa dibuka.

Dari sisi bisnis, masalahnya bukan cuma teknis. Setiap jam website mati berarti calon pelanggan dari pencarian lokal tidak bisa menghubungi pemilik usaha.

Baca juga Cara Mudah Install WordPress di Localhost untuk Pemula

Approach

MUGHU tidak langsung restore backup, karena ada kemungkinan update masih bisa diselamatkan. Urutan pendekatannya:

1. Backup kondisi saat ini.
2. Aktifkan debug.
3. Cek debug.log.
4. Nonaktifkan plugin lewat FTP.
5. Aktifkan plugin satu per satu.
6. Ganti plugin bermasalah dengan versi stabil.
7. Bersihkan cache.
8. Cek formulir kontak dan halaman layanan.

Implementation

Debug menunjukkan error seperti ini:

PHP Fatal error: Uncaught Error: Call to undefined method Form_Plugin::legacy_loader()
in /wp-content/plugins/form-addon/form-addon.php:118

Penyebabnya bukan plugin formulir utama, melainkan addon lama yang tidak cocok dengan versi terbaru.

Folder plugin addon diganti nama:

form-addon

menjadi:

form-addon_disabled

Website langsung terbuka.

Setelah itu, plugin utama tetap dipakai, addon lama diganti dengan fitur bawaan plugin utama. Formulir dites ulang dengan mengirim pesan percobaan.

Results

Hasil yang masuk akal dari kasus seperti ini:

Key Learnings

• Addon kecil bisa merusak seluruh website.
• Update sebaiknya diuji di staging untuk website yang menghasilkan prospek.
• Debug log mempercepat diagnosis.
• Restore backup bukan selalu langkah pertama, tapi wajib tersedia.
• Website lokal perlu dipulihkan cepat karena calon pelanggan sering butuh solusi saat itu juga.

Review Alat: Pilihan Tool untuk Mengatasi Error WordPress

Bagian ini bukan ulasan produk berbayar tertentu, tapi penilaian praktis atas alat yang sering dipakai saat memperbaiki error WordPress.

1. File Manager Hosting

Overview: File Manager adalah alat bawaan panel hosting untuk mengakses file website.

Fitur utama:

• Edit file wp-config.php
• Rename folder plugin
• Hapus .maintenance
• Ubah .htaccess
• Upload file WordPress

Kelebihan:

• Tidak perlu instal aplikasi
• Cepat untuk perbaikan darurat
• Cocok saat dashboard tidak bisa dibuka

Kekurangan:

• Editor kadang kurang nyaman
• Risiko salah hapus file
• Tidak seaman SFTP untuk alur kerja serius

Paling cocok untuk: perbaikan cepat di shared hosting.

Sebaiknya dihindari jika: Teman-Teman harus mengedit banyak file besar atau bekerja dalam tim teknis.

2. FTP/SFTP

Overview: FTP/SFTP membantu mengelola file WordPress dari komputer.

Fitur utama:

• Upload dan unduh folder
• Rename plugin/tema
• Backup file
• Edit file dengan editor lokal

Kelebihan:

• Lebih stabil untuk banyak file
• Nyaman untuk backup manual
• SFTP lebih aman daripada FTP biasa

Kekurangan:

• Perlu data login
• Pengguna harus lebih teliti dengan struktur folder

Paling cocok untuk: website yang dashboard-nya terkunci atau blank putih.

3. phpMyAdmin

Overview: phpMyAdmin dipakai untuk mengelola database MySQL/MariaDB lewat tampilan web.

Fitur utama:

• Export/import database
• Edit tabel wp_options
• Cek user admin
• Repair tabel database

Kelebihan:

• Bisa memperbaiki error database
• Tersedia di banyak hosting
• Berguna saat dashboard tidak bisa dibuka

Kekurangan:

• Risiko tinggi kalau salah edit
• Tampilan teknis
• Tidak cocok untuk coba-coba

Paling cocok untuk: error database dan URL WordPress salah.

4. WP-CLI

Overview: WP-CLI adalah alat baris perintah untuk mengelola WordPress.

Fitur utama:

• Update plugin
• Nonaktifkan tema
• Flush permalink
• Reinstall core
• Kelola user

Kelebihan:

• Cepat
• Bisa otomatisasi
• Cocok untuk banyak website

Kekurangan:

• Butuh SSH
• Tidak semua hosting mendukung
• Perlu terbiasa dengan terminal

Paling cocok untuk: VPS, cloud hosting, agensi, dan pengelolaan profesional.

Verdict berdasarkan kebutuhan

Kesalahan Umum Saat Mengatasi Error WordPress

Biar tidak jatuh ke lubang yang sama, hindari beberapa kebiasaan ini.

1. Mengubah terlalu banyak hal sekaligus

Ini kesalahan klasik. Misalnya mengganti tema, menghapus plugin, mengubah PHP, dan mengedit .htaccess dalam satu waktu.

Kalau website pulih, kita tidak tahu penyebabnya. Kalau makin rusak, kita juga bingung harus mundur ke mana.

2. Tidak backup sebelum edit

Edit file tanpa backup itu seperti memperbaiki genteng tanpa tangga cadangan. Bisa saja aman, tapi kalau terpeleset, repot.

3. Menghapus plugin langsung

Lebih aman rename folder dulu daripada hapus langsung. Kalau ternyata bukan penyebabnya, Teman-Teman tinggal mengembalikan nama folder.

4. Membiarkan debug aktif

Debug berguna saat perbaikan, tapi jangan dibiarkan aktif di website produksi. Pesan error bisa membocorkan struktur file.

5. Mengabaikan versi PHP

Plugin dan tema modern sering butuh versi PHP yang sesuai. Di sisi lain, tema lama bisa rusak saat PHP dinaikkan terlalu jauh.

6. Membersihkan cache hanya di satu tempat

Cache bisa ada di browser, plugin, server, CDN, bahkan DNS. Kalau hanya bersihkan satu, tampilan error lama bisa tetap muncul.

Tips Troubleshooting Berdasarkan Gejala

Website blank putih

Coba urutan ini:

1. Aktifkan debug.
2. Rename folder plugins.
3. Rename tema aktif.
4. Naikkan memory limit.
5. Cek debug.log.

Dashboard tidak bisa dibuka

Coba:

1. Browser privat.
2. Bersihkan cookie.
3. Rename plugin keamanan.
4. Rename .htaccess.
5. Cek WP_HOME dan WP_SITEURL.

Hanya halaman artikel yang 404

Coba:

1. Simpan ulang permalink.
2. Flush rewrite.
3. Cek .htaccess.
4. Cek slug artikel.
5. Buat redirect 301 jika URL berubah.

Gagal unggah gambar

Coba:

1. Cek ukuran file.
2. Cek permission uploads.
3. Naikkan upload_max_filesize.
4. Naikkan post_max_size.
5. Cek ruang disk hosting.

Error setelah update plugin

Coba:

1. Rename folder plugin terbaru.
2. Cek changelog plugin.
3. Pulihkan versi sebelumnya.
4. Laporkan ke pengembang plugin.
5. Cari alternatif kalau plugin tidak dirawat.

Error setelah update PHP

Coba:

1. Turunkan sementara versi PHP.
2. Update plugin dan tema.
3. Cek plugin yang tidak kompatibel.
4. Ganti tema lama jika perlu.
5. Uji ulang di staging.

Checklist Cepat Mengatasi Error di WordPress

Gunakan checklist ini saat sedang panik.

• Catat pesan error yang muncul
• Backup file dan database
• Aktifkan debug WordPress
• Cek wp-content/debug.log
• Cek log error server
• Nonaktifkan semua plugin
• Ganti ke tema bawaan
• Rename .htaccess
• Simpan ulang permalink
• Cek kredensial database
• Naikkan memory limit bila perlu
• Cek permission folder upload
• Bersihkan cache
• Uji website dari browser lain
• Matikan debug setelah selesai

Strategi Pencegahan Agar Error WordPress Tidak Sering Kambuh

Mencegah selalu lebih murah daripada memperbaiki. Apalagi kalau website menghasilkan penjualan, pendaftaran, iklan, atau prospek lokal.

Pakai staging untuk update besar

Staging adalah salinan website untuk pengujian. Update plugin, tema, dan PHP sebaiknya dicoba di staging dulu.

Kalau aman, baru terapkan ke website utama.

Jadwalkan backup rutin

Untuk website biasa:

• Backup mingguan mungkin cukup
• Backup harian lebih aman untuk website aktif

Untuk toko online:

• Backup database sebaiknya lebih sering
• Pesanan WooCommerce berubah setiap saat

Kurangi plugin yang tidak penting

Setiap plugin menambah beban dan risiko. Kalau dua plugin punya fungsi sama, pilih satu.

Contoh:

• Jangan pakai tiga plugin cache sekaligus
• Jangan pakai banyak plugin keamanan yang saling tumpang tindih
• Jangan simpan plugin nonaktif terlalu lama

Update bertahap

Jangan update 20 plugin sekaligus di website utama. Kalau terjadi error, sulit mencari penyebabnya.

Lebih rapi:

1. Backup.
2. Update WordPress core.
3. Update tema.
4. Update plugin penting satu per satu.
5. Cek website setiap beberapa update.

Pantau performa hosting

Cek:

• CPU usage
• RAM
• Entry process
• Disk usage
• Error log
• Bandwidth
• Database size

Kalau resource sering mentok, error bisa muncul berulang.

Konteks Local SEO: Kenapa Website Lokal Harus Cepat Pulih

Untuk bisnis lokal, error WordPress bukan cuma urusan tampilan. Misalnya website jasa AC di Surabaya, klinik gigi di Bandung, studio foto di Yogyakarta, katering di Jakarta, atau vila di Bali.

Calon pelanggan lokal biasanya mencari saat mereka sudah punya kebutuhan. Kalau website error, mereka tidak menunggu. Mereka klik pesaing.

Dampak error pada bisnis lokal

• Formulir kontak tidak terkirim
• Nomor WhatsApp tidak terlihat
• Halaman layanan tidak bisa dibuka
• Google mungkin menurunkan kualitas pengalaman halaman
• Iklan berbayar membuang biaya karena landing page rusak
• Calon pelanggan kehilangan rasa percaya

Tips khusus website lokal

• Pastikan tombol WhatsApp tetap berfungsi
• Simpan nomor kontak di Google Business Profile
• Jangan hanya mengandalkan formulir website
• Pantau halaman layanan utama
• Cek website setelah update plugin
• Pakai uptime monitoring untuk notifikasi cepat

Halaman yang wajib dicek setelah perbaikan

Untuk website lokal, cek minimal:

• Beranda
• Halaman layanan utama
• Halaman kontak
• Tombol WhatsApp
• Formulir pertanyaan
• Halaman lokasi/cabang
• Artikel SEO yang mendatangkan trafik

Template SOP Perbaikan Error WordPress untuk Tim

Kalau website dikelola oleh tim, buat SOP sederhana agar semua orang tahu harus melakukan apa.

SOP singkat saat website error

1. Laporkan gejala

   • Pesan error
   • URL terdampak
   • Waktu kejadian
   • Screenshot

2. Amankan data

   • Backup file
   • Backup database

3. Cek perubahan terakhir

   • Update plugin
   • Update tema
   • Update PHP
   • Perubahan kode
   • Instalasi plugin baru

4. Diagnosis

   • Debug WordPress
   • Log server
   • Nonaktifkan plugin
   • Ganti tema
   • Cek .htaccess

5. Perbaikan

   • Terapkan satu solusi
   • Uji hasil
   • Catat perubahan

6. Validasi

   • Cek halaman penting
   • Cek formulir
   • Cek dashboard
   • Cek tampilan mobile

7. Pencegahan

   • Update dokumentasi
   • Hapus plugin bermasalah
   • Jadwalkan backup
   • Buat staging jika belum ada

Contoh File wp-config.php yang Lebih Aman untuk Troubleshooting

Berikut contoh bagian konfigurasi yang sering dipakai saat troubleshooting.

<?php
define( 'DB_NAME', 'nama_database' );
define( 'DB_USER', 'user_database' );
define( 'DB_PASSWORD', 'password_database' );
define( 'DB_HOST', 'localhost' );

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

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

/* That's all, stop editing! Happy publishing. */

Saat perbaikan selesai, ubah bagian debug menjadi:

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

Catatan penting

Jangan membagikan isi wp-config.php ke publik. File ini berisi kredensial database. Kalau harus meminta bantuan teknisi, sensor bagian kata sandi dan nama pengguna.

Contoh Alur Diagnosis 15 Menit

Kalau website sedang error dan waktu terbatas, pakai alur cepat ini.

Menit 0–3: amankan dan catat

• Catat pesan error
• Ambil screenshot
• Cek apakah semua halaman terdampak
• Backup cepat jika panel hosting mendukung

Menit 3–6: cek penyebab paling umum

• Rename folder plugins
• Cek website
• Kalau pulih, plugin penyebabnya

Menit 6–9: cek tema dan .htaccess

• Rename tema aktif
• Rename .htaccess
• Cek website lagi

Menit 9–12: aktifkan debug

• Edit wp-config.php
• Cek debug.log
• Baca file dan baris penyebab

Menit 12–15: ambil keputusan

Troubleshooting Lanjutan untuk Server VPS

Kalau Teman-Teman memakai VPS, tanggung jawabnya lebih luas. Hosting bersama biasanya mengurus banyak hal di belakang layar. VPS tidak begitu.

Cek status web server

Untuk Apache:

sudo systemctl status apache2

Untuk Nginx:

sudo systemctl status nginx

Expected output:

active (running)

Restart web server

Apache:

sudo systemctl restart apache2

Nginx:

sudo systemctl restart nginx

Cek PHP-FPM

sudo systemctl status php8.2-fpm

Restart:

sudo systemctl restart php8.2-fpm

Cek ruang disk

df -h

Expected output:

Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1        50G   45G  5G    90% /

Kalau disk hampir penuh, upload bisa gagal dan database bisa bermasalah.

Cek penggunaan memori

free -m

Cek proses berat

top

atau:

htop

Kalau belum ada htop, instal dulu sesuai sistem operasi.

Kapan Harus Menghubungi Hosting atau Teknisi?

Tidak semua error harus diselesaikan sendiri. Kadang masalahnya memang ada di sisi server.

Hubungi penyedia hosting kalau:

• Server database down
• Website sering 502 atau 504
• CPU/RAM sering penuh
• Firewall memblokir koneksi penting
• Tidak bisa mengubah versi PHP
• File permission berubah sendiri
• Ada indikasi malware
• Backup hosting perlu dipulihkan
• Error terjadi di banyak website dalam satu akun

Hubungi teknisi WordPress kalau:

• Error berasal dari kode tema khusus
• Plugin penting bentrok dengan sistem bisnis
• WooCommerce error saat checkout
• Database perlu dibersihkan manual
• Website kena hack
• Perlu staging dan alur update profesional

FAQ Seputar Mengatasi Error di WordPress

Apakah aman menonaktifkan semua plugin?

Aman sebagai langkah diagnosis, selama tidak menghapus data plugin. Rename folder plugin atau deactivate lewat dashboard biasanya tidak menghapus pengaturan.

Tapi untuk plugin toko online, membership, LMS, atau booking, lakukan saat trafik rendah agar tidak mengganggu transaksi.

Apakah mengganti tema akan menghapus konten?

Tidak. Konten artikel dan halaman tersimpan di database. Tapi tampilan, widget, menu, dan pengaturan tema bisa berubah sementara.

Kenapa website masih error setelah diperbaiki?

Kemungkinan cache masih menyimpan tampilan lama, atau ada lebih dari satu penyebab. Bersihkan cache dan lanjutkan diagnosis satu per satu.

Apakah restore backup selalu solusi terbaik?

Restore backup cepat, tapi tidak selalu paling tepat. Kalau penyebabnya belum diketahui, error bisa muncul lagi setelah update berikutnya.

Berapa memory limit yang ideal?

Untuk blog ringan, 128M–256M sering cukup. Untuk WooCommerce, page builder berat, atau website dengan banyak plugin, 256M–512M lebih realistis.

Apakah perlu menghapus plugin yang tidak aktif?

Sebaiknya iya, kalau memang tidak dipakai. Plugin nonaktif tetap bisa menjadi risiko keamanan kalau dibiarkan lama dan tidak diperbarui.

Apa bedanya error 500 dan critical error?

Error 500 adalah pesan umum dari server. Critical error adalah pesan WordPress saat mendeteksi fatal error PHP. Keduanya bisa punya penyebab yang mirip, seperti plugin atau tema bermasalah.

Kenapa error muncul setelah update?

Karena update bisa mengubah fungsi, struktur file, atau kebutuhan versi PHP. Kalau plugin lain masih bergantung pada cara lama, konflik bisa terjadi.

Cheat Sheet Perintah Penting

Prioritas Perbaikan Berdasarkan Risiko

Pola Pikir yang Tepat Saat Memperbaiki WordPress

Saat mengatasi error di WordPress, jangan buru-buru merasa semua rusak. WordPress punya banyak lapisan, dan sering kali satu lapisan saja yang bermasalah.

Pola pikir yang membantu:

• Jangan panik.
• Jangan langsung hapus.
• Jangan ubah banyak hal sekaligus.
• Selalu cari petunjuk dari log.
• Simpan catatan perubahan.
• Pulihkan akses utama dulu.
• Setelah aman, baru rapikan akar masalah.

Kalau Teman-Teman mengelola website bisnis, perlakukan troubleshooting seperti proses operasional, bukan kegiatan dadakan. Website yang terawat rapi jauh lebih murah dijaga daripada website yang baru disentuh setelah rusak.

Kesimpulan

Mengatasi error di WordPress bukan soal menebak-nebak tombol mana yang harus diklik, tapi soal membaca gejala, mencari sumber masalah, lalu memperbaikinya dengan urutan yang aman. Mulai dari backup, cek log, nonaktifkan plugin atau tema yang mencurigakan, periksa versi PHP, bersihkan cache, sampai memastikan database dan file inti tetap sehat. Dengan alur seperti ini, Teman-Teman bisa mengurangi risiko website makin rusak saat proses perbaikan.

Yang paling penting, jangan memperlakukan semua error dengan cara yang sama. Error 500, critical error, masalah permalink, gagal upload, konflik plugin, atau website lambat punya prioritas dan pendekatan berbeda. Kalau ingin diagnosis lebih teknis, dokumentasi resmi tentang debugging di WordPress bisa jadi rujukan yang bagus untuk memahami cara membaca error secara lebih dalam.

Website WordPress yang sehat biasanya bukan hasil dari sekali perbaikan besar, tapi dari kebiasaan kecil yang konsisten: update terkontrol, plugin seperlunya, backup rutin, monitoring sederhana, dan catatan perubahan yang rapi. Jadi, saat error muncul lagi nanti, Teman-Teman tidak mulai dari panik, tapi dari prosedur yang jelas. Mulai perbaiki dari yang paling aman, catat setiap langkah, dan jadikan troubleshooting sebagai bagian dari cara merawat website secara profesional.

Referensi

Hostinger. (2026). Error WordPress paling umum dan cara mengatasinya.

Dewaweb Blog. (2026). Error pada WordPress dan solusi tepat mengatasinya.

SCND Digital. (2026). Mengatasi error umum pada WordPress dan solusi memperbaikinya.

DomaiNesia. (2026). Kumpulan kasus error WordPress dan cara mengatasinya.

Hostinger. (2026). Cara mengatasi critical error pada website WordPress.

LamanWP. (2026). Error WordPress yang sering terjadi dan cara mengatasinya.

Landfoster. (2026). Cara memperbaiki error WordPress umum dengan mudah.

Gapurahoster. (2026). Cara mengatasi error WordPress an unexpected error occurred.

Sobatcloud. (2026). Error WordPress dan cara cepat mengatasinya.

Romeltea. (2026). Error website WordPress, penyebab, dan cara mengatasinya.