Cara Mengatasi Error 504 Gateway Timeout di WordPress

Cara Mengatasi Error 504 Gateway Timeout di WordPress 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?

Proxy menunggu respons dari PHP atau upstream lebih lama daripada batas timeout.

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

• Query database lambat.
• Backup/import berjalan lewat request web.
• Api eksternal tidak merespons.
• Php worker atau cpu penuh.

Langkah Diagnosis

1. Cocokkan waktu 504 dengan slow query log dan php log.
2. Gunakan query monitor di staging.
3. Periksa cron serta http api call.
4. Uji tanpa plugin yang melakukan sinkronisasi.

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: Optimalkan query dan index.
2. Langkah 2: Pindahkan tugas panjang ke wp-cli atau background job.
3. Langkah 3: Beri timeout dan fallback pada api eksternal.
4. Langkah 4: Naikkan timeout hanya setelah bottleneck diperbaiki.

Contoh Konfigurasi atau Perintah

# Jalankan tugas panjang lewat CLI, bukan browser
wp cron event run --due-now
wp db optimize

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

Ulangi request yang sama sambil memantau durasi. Pastikan selesai di bawah timeout dan tidak menumpuk worker.

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 error 504 gateway timeout di wordpress dapat didiagnosis lebih cepat tanpa menebak-nebak.

Kesimpulan

Cara Mengatasi Error 504 Gateway Timeout di WordPress 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.