Cara Mengatasi Permalink WordPress Error 404

Cara Mengatasi Permalink WordPress Error 404 perlu ditangani berdasarkan pesan error, log, dan perubahan terakhir pada website. Jangan langsung menghapus plugin, database, atau file tanpa backup karena tindakan acak dapat menghilangkan bukti penyebab dan memperbesar kerusakan.

Apa Arti Error Ini?

Posting ada, tetapi aturan rewrite tidak meneruskan URL cantik ke index.php.

Catat apakah masalah terjadi pada semua halaman, hanya wp-admin, hanya satu URL, atau hanya ketika menjalankan tindakan tertentu. Perbedaan tersebut membantu menentukan apakah sumber masalah berada pada web server, PHP, database, plugin, tema, browser, atau jaringan.

Gejala yang Perlu Dicatat

• Pesan error lengkap, termasuk kode HTTP, nama file, nomor baris, atau request yang gagal.
• Waktu kejadian dan perubahan terakhir seperti update, migrasi, instalasi plugin, perubahan PHP, atau pemasangan SSL.
• Apakah error juga muncul ketika cache browser, plugin cache, CDN, dan proxy dilewati.
• Apakah masalah dapat direproduksi pada staging atau hanya terjadi di server produksi.

Penyebab yang Paling Relevan

• .htaccess hilang.
• Mod_rewrite/allowoverride tidak aktif.
• Nginx try_files salah.
• Rewrite_rules cache belum diperbarui.

Langkah Diagnosis

1. Uji permalink plain.
2. Save permalinks.
3. Periksa config server.
4. Cek .htaccess writable.

Aktifkan Log WordPress dengan Aman

Gunakan logging saat diagnosis, tetapi jangan menampilkan detail PHP kepada pengunjung. Tambahkan konfigurasi berikut sebelum baris penghenti pada wp-config.php, lalu nonaktifkan kembali setelah masalah selesai.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Setelah error direproduksi, periksa wp-content/debug.log dan error log dari panel hosting. Fokus pada entri dengan waktu yang sama, bukan warning lama yang tidak terkait.

Cara Mengatasinya

1. Langkah 1: Flush rewrite.
2. Langkah 2: Pulihkan aturan apache/nginx.
3. Langkah 3: Aktifkan module/config yang diperlukan.
4. Langkah 4: Hindari flush pada setiap request.

Contoh Konfigurasi atau Perintah

wp rewrite structure '/%postname%/'
wp rewrite flush --hard

Sesuaikan nama domain, path, username, versi, dan nilai konfigurasi dengan server Anda. Jalankan perintah hanya jika memiliki akses dan memahami dampaknya. Pada shared hosting, tindakan seperti restart service atau perubahan virtual host perlu dilakukan oleh penyedia hosting.

Cara Memastikan Perbaikan Berhasil

Single post, category, author, pagination, dan custom post type tidak lagi 404.

Selain melihat tampilan website, periksa status HTTP, log baru, fungsi login, proses simpan posting, REST API, cron, dan halaman yang menggunakan plugin atau tema terkait. Perbaikan belum dianggap selesai bila error hanya hilang karena komponen utama dimatikan tanpa solusi permanen.

Jika wp-admin Tidak Dapat Dibuka

Gunakan Recovery Mode bila WordPress mengirim email fatal error. Alternatif lain adalah WP-CLI atau File Manager untuk menonaktifkan komponen yang jelas disebut pada stack trace. Rename folder sebaiknya hanya digunakan sebagai langkah pemulihan sementara, lalu status plugin atau tema perlu dirapikan setelah dashboard dapat dibuka.

Hal yang Sebaiknya Tidak Dilakukan

• Jangan memakai permission 777 sebagai solusi permanen.
• Jangan menonaktifkan pemeriksaan SSL, firewall, atau validasi keamanan secara global hanya untuk menghilangkan pesan error.
• Jangan menghapus tabel, folder uploads, atau file konfigurasi sebelum memiliki backup dan mengetahui pemilik datanya.
• Jangan menaikkan memory, timeout, worker, atau resource tanpa memeriksa proses yang menghabiskannya.
• Jangan mengedit file core WordPress untuk memperbaiki plugin atau tema.

Pencegahan

Sediakan staging, backup yang pernah diuji restore, pencatatan perubahan, monitoring uptime, dan pembaruan terjadwal. Gunakan plugin dan tema dari sumber tepercaya, hapus komponen yang tidak dipakai, batasi hak akses, serta pantau Site Health dan log server. Dengan prosedur tersebut, cara mengatasi permalink wordpress error 404 dapat didiagnosis lebih cepat tanpa menebak-nebak.

Kesimpulan

Cara Mengatasi Permalink WordPress Error 404 harus diselesaikan dari bukti teknis: pesan lengkap, log pada waktu kejadian, status HTTP, serta perubahan terakhir. Ikuti diagnosis dari lapisan paling dekat dengan gejala, lakukan satu perubahan pada satu waktu, lalu verifikasi kembali seluruh fungsi terkait sebelum menutup masalah.