Website WordPress Anda mengalami error 504 Gateway Timeout? Pelajari penyebab teknis dan 7 langkah praktis memulihkan akses situs dengan cepat tanpa bahaya.

Bayangkan situasi ini: Anda sedang menjalankan kampanye promosi penting, meluncurkan produk baru, atau sekadar ingin memperbarui artikel blog reguler Anda. Namun, saat membuka alamat URL website WordPress milik Anda, layar monitor tidak menampilkan halaman web yang indah, melainkan pesan bernuansa putih polos dengan tulisan seram: “504 Gateway Timeout” atau “HTTP ERROR 504”.

Seketika itu juga, rasa panik mulai menguasai. Pengunjung tidak bisa mengakses toko online Anda, transaksi terhenti, dan algoritma Google yang sedang melakukan perayapan (crawling) mencatat bahwa situs Anda sedang tidak dapat dijangkau. Bagi pemilik website, pengembang web (developer), maupun administrator sistem, error 504 adalah salah satu jenis gangguan teknis yang paling menjengkelkan karena penyebabnya bisa berasal dari berbagai lapisan infrastruktur server.

Namun, Anda tidak perlu khawatir secara berlebihan. Di dalam panduan mendalam ini, tim teknis dari fixproject.net akan membedah secara tuntas mulai dari konsep dasar apa itu pesan kesalahan HTTP 504, akar penyebab teknis di balik layarnya, hingga 7 langkah solutif yang sistematis untuk mengatasi kendala ini tanpa perlu menguasai ilmu koding tingkat tinggi.

Apa Itu Error 504 Gateway Timeout dan Mengapa Terjadi?

Secara teknis dalam protokol HTTP, pesan dengan kode status 504 Gateway Timeout adalah bagian dari kategori kesalahan tingkat server (5xx Server Errors). Pesan ini muncul ketika sebuah server yang bertindak sebagai gerbang (gateway) atau perantara (proxy) tidak menerima respon tepat waktu dari server hulu (upstream server) yang seharusnya memproses permintaan tersebut.

Untuk memahami analogi sederhananya, bayangkan Anda sedang memesan makanan di sebuah restoran mewah. Anda (sebagai Browser/Client) memesan menu kepada pelayan (sebagai Server Gateway/Proxy seperti Nginx, Cloudflare, atau LiteSpeed). Pelayan tersebut kemudian berjalan ke dapur belakang untuk menyampaikan pesanan Anda kepada koki utama (sebagai Upstream Application Server/PHP-FPM yang mengeksekusi script WordPress dan database MySQL).

Jika koki di dapur sangat sibuk, kewalahan menangani ratusan pesanan sekaligus, atau pingsan karena kelelahan, maka pelayan akan berdiri menunggu di depan pintu dapur dalam durasi waktu tertentu (timeout limit). Ketika batas waktu tunggu tersebut habis dan koki belum juga memberikan makanan, pelayan akan kembali ke meja Anda dan berkata: “Maaf, dapur belakang tidak merespon dalam batas waktu yang ditentukan.” Inilah persisnya yang terjadi saat layar Anda menampilkan pesan 504 Gateway Timeout.

Catatan Teknis Penting: Error 504 sangat berbeda dengan Error 500 (Internal Server Error) atau Error 502 (Bad Gateway). Pada Error 502, server hulu memberikan respon yang tidak valid (invalid response). Sedangkan pada Error 504, server hulu sebenarnya sedang bekerja atau macet, namun membutuhkan waktu yang melebihi batas toleransi (time limit) yang dikonfigurasi pada server gateway.

Penyebab Utama Munculnya Error 504 di WordPress

Sebelum kita melangkah ke proses perbaikan teknis, penting bagi Anda untuk memahami variabel apa saja dalam ekosistem WordPress yang kerap menjadi pemicu kebuntuan proses ini. Berdasarkan pengalaman penanganan kasus pada berbagai proyek teknis di fixproject.net, berikut adalah beberapa pemicu utamanya:

1. Lonjakan Trafik Tiba-Tiba (Traffic Spike): Jika server hosting Anda memiliki spesifikasi terbatas (resource limit) dan tiba-tiba menerima lonjakan pengunjung secara bersamaan, antrean pemrosesan PHP akan menumpuk sehingga memicu keterlambatan respon.

2. Plugin atau Tema yang Rusak / Loba Resource: Plugin yang ditulis dengan kualitas koding buruk, mengalami kebocoran memori (memory leak), atau melakukan pemanggilan API eksternal (third-party API) yang lambat dapat menghentikan eksekusi script WordPress secara mendadak.

3. Batas Memori PHP (PHP Memory Limit) Terlalu Rendah: Batas alokasi memori bawaan dari penyedia hosting sering kali terlalu kecil untuk menangani tugas-tugas berat seperti impor data, kalkulasi WooCommerce, atau eksekusi pembaruan modul.

4. Koneksi Database MySQL yang Lambat / Overload: Query database yang tidak dioptimalkan atau tabel database yang terlalu besar (misalnya penumpukan transient data dan revision logs) dapat membuat eksekusi database menjadi memakan waktu lama.

5. Masalah pada Content Delivery Network (CDN) / Firewall: Layanan CDN seperti Cloudflare atau Sucuri terkadang mengalami kendala komunikasi dengan server asal (origin server) tempat file website Anda disimpan.

6. Konfigurasi Server (Nginx / Apache / PHP-FPM) yang Tidak Tepat: Nilai batas waktu eksekusi seperti max_execution_time atau request_terminate_timeout diset terlalu pendek.

7 Langkah Solutif Mengatasi Error 504 Gateway Timeout pada WordPress

Berikut adalah urutan langkah perbaikan yang dirancang secara bertahap, dimulai dari metode teruji yang paling aman hingga solusi tingkat lanjut di level konfigurasi server.

Langkah 1: Lakukan Hard Refresh dan Bersihkan Cache Lokal Browser

Sering kali, error 504 bersifat sementara yang disebabkan oleh kedipan singkat pada koneksi jaringan server. Sebelum melakukan pengubahan file yang kompleks, pastikan terlebih dahulu bahwa masalah tersebut bukan sekadar cache yang tersangkut di peramban Anda.

• Lakukan Hard Refresh dengan menekan tombol Ctrl + F5 (pada Windows) atau Cmd + Shift + R (pada Mac OS). Tindakan ini memaksa browser untuk meminta salinan halaman baru dari server secara langsung tanpa menggunakan cache lokal.

• Coba akses website Anda menggunakan mode Penyamaran (Incognito Window) atau gunakan browser lain.

• Gunakan layanan pemeriksaan pihak ketiga seperti DownForEveryoneOrJustMe.com atau IsItDownRightNow.com untuk memastikan apakah gangguan ini dirasakan oleh seluruh dunia atau hanya pada jaringan lokal Anda.

Langkah 2: Deaktivasi Semua Plugin WordPress via FTP atau cPanel

Jika masalah terjadi saat Anda mencoba memperbarui plugin atau setelah memasang plugin baru, besar kemungkinan terdapat konflik koding atau script yang menggantung (hung script). Karena halaman dashboard admin (wp-admin) biasanya tidak dapat diakses saat terjadi error 504, kita akan menonaktifkannya melalui pengelola file.

1. Buka aplikasi FTP Client seperti FileZilla atau masuk ke akun cPanel / DirectAdmin Anda lalu buka menu File Manager.

2. Navigasikan direktori menuju folder utama website Anda, lalu buka folder wp-content.

3. Cari folder bernama plugins.

4. Ubah nama folder tersebut (rename) menjadi plugins_old atau plugins_deactivated.

5. Coba muat ulang website Anda di browser. Jika website kembali normal, berarti salah satu plugin Anda adalah penyebab utama error 504 tersebut.

6. Kembalikan nama folder menjadi plugins, lalu buka folder tersebut dan ubah nama folder plugin satu per satu untuk mengisolasi plugin mana yang bermasalah secara spesifik.

Tips Pengembang: Jika Anda memiliki akses terminal SSH ke server, Anda dapat menonaktifkan seluruh plugin dalam waktu satu detik menggunakan komando WP-CLI berikut:

wp plugin deactivate --all

Langkah 3: Naikkan Batas Memori PHP (PHP Memory Limit) dan Max Execution Time

Penyebab paling umum kedua dari kasus yang ditangani tim fixproject.net adalah keterbatasan alokasi memori yang disediakan oleh sistem untuk mengeksekusi skrip WordPress. Ketika skrip kehabisan memori di tengah jalan, proses akan berhenti merespon dan memicu gateway timeout.

Anda dapat menaikkan nilai ini dengan menyunting file wp-config.php yang terletak di root direktori website Anda. Tambahkan baris kode berikut sebelum kalimat / That’s all, stop editing! Happy publishing. /:

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

Selain alokasi memori, Anda juga perlu memperpanjang batas waktu eksekusi skrip PHP melalui file .htaccess (jika server Anda menggunakan Apache atau LiteSpeed). Tambahkan baris berikut di bagian paling bawah file .htaccess:

php_value max_execution_time 300
php_value max_input_time 300
php_value memory_limit 256M

Bagi pengguna server berbasis Nginx dan PHP-FPM, Anda dapat menyesuaikan konfigurasi pada file php.ini dengan mengubah parameter berikut:

max_execution_time = 300
memory_limit = 256M

Langkah 4: Ganti ke Tema Bawaan Standar WordPress (Default Theme)

Sama halnya dengan plugin, tema WordPress yang sarat akan fitur kompleks, pemungutan data API eksternal, atau script page builder yang berat bisa mengalami kebocoran memori. Untuk memastikan apakah tema Anda yang menjadi biang keladi:

1. Masuk ke File Manager di cPanel / FTP, navigasikan ke wp-content/themes/.

2. Temukan folder tema aktif Anda (misalnya: astra, divi, atau flatsome), lalu ubah namanya menjadi nama-tema-old.

3. Secara otomatis, WordPress akan melakukan fallback dan mengaktifkan tema bawaan standar seperti Twenty Twenty-Four.

4. Periksa apakah website Anda sudah bisa diakses kembali dengan lancar.

Langkah 5: Nonaktifkan Sementara CDN atau Web Application Firewall (WAF)

Layanan CDN seperti Cloudflare menyediakan lapisan keamanan ekstra dan mempercepat distribusi konten. Namun, ketika jaringan CDN tidak dapat terhubung ke server asal (origin server) dalam jangka waktu tertentu, Cloudflare akan menampilkan halaman error bertuliskan “Error 504: Gateway Timeout” berserta logo Cloudflare.

Untuk menguji apakah masalah berada di CDN atau server hosting Anda:

• Login ke dashboard Cloudflare Anda.

• Pilih domain yang bermasalah, lalu aktifkan mode Development Mode atau pause Cloudflare pada domain tersebut (Pause Cloudflare on Site).

• Atau ubah pengaturan DNS A Record dari status Proxied (ikon awan oranye) menjadi DNS Only (ikon awan abu-abu) untuk sementara waktu.

• Tunggu beberapa menit hingga perubahan propagasi DNS lokal berlaku, lalu cek kembali akses website Anda. Jika website beroperasi normal, berarti terjadi blokir IP atau kendala batas waktu koneksi antara Cloudflare dan firewall server hosting Anda.

Langkah 6: Optimalkan dan Bersihkan Database MySQL WordPress

Database WordPress yang membengkak karena penumpukan jutaan data sampah (seperti post revisions, spam comments, expired transients, dan orphan metadata) dapat membuat proses eksekusi pencarian query database berjalan sangat lambat (slow query). Ketika sebuah query membutuhkan waktu puluhan detik untuk diselesaikan, koneksi PHP akan time out.

Untuk membersihkannya secara manual jika Anda bisa mengakses cPanel:

1. Buka alat phpMyAdmin di cPanel.

2. Pilih database yang digunakan oleh situs WordPress Anda.

3. Pilih semua tabel, lalu klik pada opsi drop-down di bagian bawah bertuliskan “Optimize table”.

4. Bila perlu, Anda dapat menghapus data transient yang kadaluarsa pada tabel wp_options menggunakan query SQL berikut:

DELETE FROM wp_options WHERE option_name LIKE ('%\_transient\_%');

Langkah 7: Tinjau Error Log Server dan Hubungi Penyedia Hosting

Jika Anda telah mencoba enam langkah di atas namun error 504 masih terus membayangi website Anda, saatnya memeriksa bukti rekaman digital pada log server untuk menemukan lokasi tepat di mana proses mengalami kegagalan.

Buka file debug.log yang berlokasi di direktori wp-content/debug.log. (Pastikan Anda telah mengaktifkan fungsi debugging di file wp-config.php dengan menambahkan define('WP_DEBUG', true); dan define('WP_DEBUG_LOG', true);).

Selain itu, periksa file error_log yang berada di cPanel. Cermati baris pesan terakhir yang bertuliskan Fatal Error, PHP Out of Memory, atau Connection Timed Out. Kirimkan baris log tersebut kepada tim dukungan teknis (Technical Support) penyedia hosting Anda.

Penyedia hosting memiliki akses penuh ke log tingkat server utama (seperti log Nginx/Apache dan log PHP-FPM) dan dapat menyesuaikan nilai konfigurasi seperti proxy_read_timeout atau fastcgi_read_timeout di tingkat server yang tidak dapat dijangkau oleh pengguna biasa.

Tabel Ringkasan Diagnosa & Solusi Cepat Error 504

Strategi Pencegahan Agar Error 504 Tidak Terulang Kembali

Memperbaiki masalah saat terjadi adalah langkah darurat, tetapi membangun infrastruktur website yang tangguh adalah kunci keberlanjutan bisnis digital Anda jangka panjang. Berikut adalah beberapa praktik terbaik yang selalu kami terapkan di fixproject.net untuk mencegah masalah gateway timeout di masa mendatang:

1. Gunakan Penyedia Cloud Hosting Berkinerja Tinggi: Hindari penggunaan shared hosting berbiaya sangat murah untuk website bisnis atau e-commerce yang memiliki beban trafik tinggi. Pertimbangkan untuk berpindah ke layanan Cloud Hosting terkelola atau Virtual Private Server (VPS) yang menggunakan arsitektur server LiteSpeed Enterprise atau Nginx dengan PHP-FPM.

2. Rutin Melakukan Pemeliharaan Database: Pasang plugin pemeliharaan otomatis seperti WP-Optimize atau Advanced Database Cleaner untuk menghapus draft, revisions, dan transient data secara berkala setiap minggu.

3. Pilih Plugin yang Minimalis dan Teroptimasi: Hindari kebiasaan menginstal terlalu banyak plugin untuk fungsi-fungsi kecil yang sebenarnya bisa diselesaikan dengan beberapa baris kode sederhana. Batasi penggunaan plugin maksimal 20–25 plugin yang benar-benar esensial dan dikembangkan oleh developer tepercaya.

4. Terapkan Caching di Tingkat Server: Manfaatkan teknologi object caching seperti Redis atau Memcached. Object caching menyimpan hasil query database di dalam memori RAM server, sehingga permintaan data yang sama tidak perlu membebankan kerja engine database MySQL secara berulang-ulang.

5. Gunakan Pemantauan Uptime Berkelanjutan (Uptime Monitoring): Pasang layanan pemantau otomatis seperti UptimeRobot atau Better Stack. Layanan ini akan langsung mengirimkan notifikasi via Email atau Telegram saat website Anda mulai menunjukkan tanda-tanda respon lambat atau error 504, sehingga Anda dapat mengambil tindakan perbaikan sebelum banyak pengunjung menyadarinya.

Kesimpulan

Error 504 Gateway Timeout memang tampak menakutkan bagi pemula, namun dengan pendekatan troubleshooting yang terstruktur dan sistematis, masalah ini dapat diselesaikan dengan relatif cepat. Kunci utama penyelesaiannya terletak pada pemahaman bahwa error ini adalah indikasi adanya kemacetan komunikasi antara perantara server dan pemroses data utama.

Dengan mengikuti 7 langkah taktis yang telah dijabarkan di atas—mulai dari isolasi plugin, peningkatan batas memori PHP, hingga optimasi koneksi CDN dan database—website WordPress Anda akan kembali beroperasi secara optimal, cepat, dan siap menyambut para calon pengunjung tanpa gangguan teknis.

Apakah Anda masih mengalami kesulitan dalam menangani masalah teknis, kegagalan sistem, atau pembengkakan resource pada proyek web Anda? Jangan ragu untuk menjelajahi artikel solusi teknis lainnya hanya di fixproject.net—pusat panduan pemulihan dan optimasi proyek digital tepercaya Anda.