Arti Kode Error 502 Bad Gateway dan 503 Service Unavailable

Saat membuka sebuah website dan yang muncul bukan halaman utama melainkan tulisan 502 Bad Gateway atau 503 Service Unavailable, banyak orang menyimpulkan hal yang sama: "websitenya rusak". Kenyataannya lebih menarik — dua kode ini bercerita tentang apa yang sedang terjadi di server, dan keduanya punya arti yang berbeda. Artikel ini menjelaskan artinya dalam bahasa sederhana, perbedaannya dengan error keluarga 5xx lainnya, dan apa yang sebaiknya Anda lakukan sebagai pengunjung.

Latar cepat: apa itu kode status HTTP?

Setiap kali browser meminta sebuah halaman, server menjawab dengan kode status tiga digit. Keluarga kodenya mudah diingat: 2xx berarti sukses (200 OK adalah yang paling umum), 3xx berarti dipindahkan (redirect), 4xx berarti kesalahan dari sisi pengunjung (404 halaman tidak ada, 403 dilarang), dan 5xx berarti kesalahan di sisi server. Jadi setiap kali Anda melihat angka yang dimulai dengan 5, masalahnya hampir pasti bukan di perangkat Anda.

502 Bad Gateway: "penerjemahnya yang bermasalah"

Website besar modern jarang berjalan sebagai satu server tunggal. Biasanya ada beberapa lapis: server depan yang menerima permintaan pengunjung, lalu server aplikasi di belakangnya yang benar-benar menghasilkan halaman. Server depan bekerja seperti resepsionis — menerima permintaan, meneruskannya ke belakang, dan menyampaikan jawabannya kembali.

502 Bad Gateway berarti resepsionis itu berhasil bertanya ke belakang, tetapi mendapat jawaban yang tidak valid atau tidak ada sama sekali. Penyebab umumnya:

Proses aplikasi di server belakang crash atau belum selesai dinyalakan setelah rilis baru;
Server aplikasi kelebihan beban sehingga tidak sempat menjawab dengan benar;
Kesalahan konfigurasi saat deploy, misalnya server depan diarahkan ke port yang salah.

Bagi pengunjung, 502 biasanya sementara: begitu tim teknis memulai ulang proses aplikasi atau rilis yang bermasalah ditarik, halaman langsung normal kembali.

503 Service Unavailable: "sibuk, tolong antre lagi nanti"

503 berarti server sadar permintaan Anda sah, tetapi saat ini tidak mampu melayaninya. Ini kode yang paling sering muncul di dua situasi:

Lonjakan trafik. Saat flash sale tengah malam, konser dibuka, atau berita besar menyeret ribuan orang ke satu halaman, server kehabisan kapasitas dan mulai menolak permintaan baru dengan 503.
Pemeliharaan (maintenance). Banyak situs sengaja mematikan layanannya sejenak untuk update dan menampilkan 503 — kadang disertai halaman "kembali lagi nanti". 503 bahkan bisa disertai header Retry-After yang memberi tahu berapa detik sebaiknya dicoba lagi.

Ciri khas 503: biasanya tidak perlu panik sama sekali. Ini cara sistem melindungi dirinya agar tidak runtuh total, dan trafik yang melandai akan dilayani kembali.

502 vs 503 vs 500 vs 504 — beda apa?

500 Internal Server Error: kesalahan umum di aplikasi tanpa detail; pembungkus paling generik.
502 Bad Gateway: lapis depan hidup, lapis belakang memberi jawaban rusak/tidak ada.
503 Service Unavailable: server sadar dan sengaja menolak sementara — kelebihan beban atau maintenance.
504 Gateway Timeout: lapis depan menunggu jawaban lapis belakang terlalu lama lalu menyerah.

Praktisnya: 500, 502, dan 504 menunjukkan sesuatu yang rusak; 503 menunjukkan sesuatu yang sibuk atau sedang dipersiapkan. Keduanya sama-sama di luar kendali Anda sebagai pengunjung.

Yang perlu Anda lakukan saat melihatnya

Tunggu 1–5 menit lalu muat ulang. Sebagian besar 502/503 selesai dalam hitungan menit.
Hindari refresh liar berkali-kali. Justru menambah beban server yang sedang kewalahan.
Cek dashboard pemantau seperti XP Down Detector — jika layanan yang Anda tuju sedang melonjak laporannya, Anda tidak sendirian dan cukup menunggu.
Kerjakan yang lain dulu. Benar-benar, ini satu-satunya strategi terbaik untuk 5xx.
Kalau error bertahan berjam-jam, kemungkinan ada insiden besar; periksa kanal resmi penyedia layanan untuk kabar terbaru.

Kalau website-nya milik Anda sendiri?

Maka 502/503 adalah sinyal untuk memeriksa log server aplikasi (biasanya crash atau OOM), memastikan kapasitas cukup untuk trafik puncak, mengaktifkan penanganan antrean, dan menyiapkan halaman maintenance yang ramah. Monitoring eksternal seperti yang kami jalankan di XP Down Detector membantu karena memberi tahu Anda sebelum pelanggan mulai mengeluh di media sosial.

Ringkasan

502 dan 503 adalah pesan dari server — bukan dari perangkat Anda. Keduanya hampir selalu sementara, dan tindakan terbaik Anda adalah menunggu, sesekali memuat ulang, dan memantau statusnya lewat dashboard kami. Simpan halaman ini; lain kali teman Anda bertanya "kenapa website ini error?", Anda bisa menjawab dengan percaya diri.