Kode status HTTP 502 Bad Gateway merupakan indikasi bahwa sebuah peladen (server) yang bertindak sebagai gateway atau proxy menerima respons yang tidak valid dari peladen hulu (upstream server). Masalah ini sering kali terjadi pada tingkat jaringan di belakang layar, melibatkan komunikasi antar-peladen sebelum halaman web berhasil dimuat di peramban Anda.
Bagi pengguna umum, kesalahan ini biasanya ditandai dengan pesan seperti "502 Bad Gateway", "Error 502", atau "The proxy server received an invalid response from an upstream server". Meskipun umumnya bersumber dari masalah di sisi peladen atau penyedia layanan hosting, beberapa langkah pemecahan masalah sederhana dapat dilakukan baik oleh pengunjung situs maupun pengelola web.
Matriks Penyebab dan Solusi 502 Bad Gateway
Berikut adalah tabel ringkasan mengenai berbagai kemungkinan penyebab galat 502 Bad Gateway beserta langkah penanganannya:
| Penyebab Utama | Pihak yang Terdampak | Tindakan Solusi Praktis |
|---|---|---|
| Peladen hulu (upstream) down atau overload | Pengunjung & Pengelola Web | Muat ulang halaman (refresh) atau tunggu beberapa saat hingga peladen pulih. |
| Kesalahan konfigurasi pada Gateway/Proxy (misal: Nginx/Apache) | Pengelola Web | Periksa berkas konfigurasi proxy_pass atau timeout pada peladen web. |
| Masalah DNS atau Cache peramban | Pengunjung | Hapus cache dan cookies peramban, atau lakukan flush DNS. |
| Skrip atau aplikasi web mengalami timeout (PHP-FPM/Database) | Pengelola Web | Optimalkan kueri database dan tingkatkan batas waktu eksekusi skrip. |
Langkah Perbaikan untuk Pengunjung Situs
Jika Anda sedang berselancar di internet dan mendadak menemui galat ini, lakukan beberapa langkah berikut untuk memastikan masalah bukan berasal dari perangkat atau koneksi Anda:
- Muat Ulang Halaman (Refresh): Tekan tombol F5 atau Ctrl+F5 untuk memuat ulang halaman. Terkadang gangguan bersifat sementara pada peladen.
- Bersihkan Cache Peramban: Data tembolok yang rusak dapat memicu kesalahan tampilan atau komunikasi. Hapus cache dan cookies pada peramban Anda, lalu coba akses kembali.
- Coba Peramban atau Perangkat Lain: Pastikan masalah bukan berasal dari aplikasi peramban yang Anda gunakan saat ini dengan beralih ke peramban alternatif.
- Periksa Koneksi Jaringan: Putuskan dan sambungkan kembali jaringan internet atau router Anda jika diperlukan.
Langkah Penanganan untuk Pengelola Situs Web
Bagi administrator atau pengelola peladen, penanganan 502 Bad Gateway memerlukan pemeriksaan mendalam pada log peladen:
- Periksa log error pada peladen web (seperti Nginx atau Apache) untuk mengetahui detail respons dari peladen hulu.
- Uji konektivitas antara reverse proxy dan application server (misalnya backend Node.js, Python, atau PHP-FPM).
- Sesuaikan pengaturan batas waktu (timeout) apabila proses eksekusi skrip memakan waktu lebih lama dari batas yang diizinkan oleh proxy.