Error HTTP 502 berarti server perantara menerima balasan yang buruk dari server asli
Error HTTP 502, 'Bad Gateway', berarti server yang Anda tuju hanyalah perantara, dan server di belakangnya memberi respons yang tidak valid atau tidak memberi respons yang bisa dipakai sama sekali. Perantaranya (Nginx, Apache, Cloudflare, load balancer AWS) berjalan normal; yang bermasalah adalah server di belakangnya.
Kode ini termasuk keluarga 5xx, jadi menurut definisinya ini adalah error di sisi server. Kode ini lebih spesifik daripada 500: ia menunjukkan kegagalan terjadi saat data diteruskan dari gateway ke server aplikasi. Halaman referensi MDN (diperbarui 22 Juni 2026) menambahkan bahwa jika server asal mengirim error HTTP yang benar, gateway seharusnya meneruskannya. Kode 502 berarti gateway tidak punya respons yang layak untuk diteruskan.
Anda bisa menemukannya sebagai halaman putih polos bertuliskan '502 Bad Gateway' di browser, sebagai 'HTTP error! status: 502' di kotak error sebuah aplikasi, dan di Zoom, game, atau aplikasi trading sebagai 'server error' umum dengan angka 502 terselip di rincian. Artinya selalu sama: bagian back end layanan tidak menjawab pintu depannya sendiri.
Server, saat bertindak sebagai gateway atau proxy, menerima respons yang tidak valid dari server hulu yang diaksesnya saat berusaha memenuhi permintaan.
RFC 9110, sebagaimana dikutip di halaman 502 Authgear
Permintaan Anda melewati sebuah gateway, dan di sanalah error 502 muncul
Error 502 muncul dari titik perantara: browser Anda berhubungan dengan gateway (reverse proxy, CDN, atau load balancer), gateway berhubungan dengan server aplikasi, dan gateway mengirim 502 saat hubungan terakhir itu gagal.
Halaman Authgear menyebutkan empat cara hubungan terakhir itu gagal: server aplikasi tidak berjalan, server menutup koneksi secara tiba-tiba, server mengirim respons HTTP yang rusak, atau server butuh waktu lebih lama dari batas waktu gateway. Pada keempatnya, gateway tidak punya respons valid untuk diteruskan, jadi ia membuat halaman error singkatnya sendiri dan mengirimkannya.
Tampilan merek pada halaman error menunjukkan perantara mana yang menyerah. Halaman 502 bergaya Cloudflare berarti Cloudflare tidak mendapat jawaban yang baik dari server asal situs. Halaman polos dengan tulisan 'nginx' atau 'openresty' di bagian bawah berarti proxy milik situs itu tidak dapat menjangkau aplikasinya sendiri di mesin atau jaringan yang sama.
Tanda bahwa masalahnya ada di situs
- Orang lain melaporkan error yang sama pada waktu yang sama
- Halaman error menampilkan merek situs atau CDN-nya
- Semua halaman di situs itu gagal dimuat, bukan hanya satu
- Ponsel Anda yang memakai data seluler menampilkan 502 yang sama
Tanda bahwa masalahnya ada di sisi Anda
- Situs itu bisa dibuka oleh teman Anda saat ini
- Hanya satu jaringan (rumah, kafe, kantor) yang menampilkannya
- Error hilang saat Anda berganti server VPN atau mematikan VPN
- Error mulai muncul tepat setelah Anda mengubah pengaturan DNS atau proxy
502, 503, dan 504 adalah tiga masalah yang berbeda dari gateway yang sama
502 berarti back end memberikan respons yang salah, 503 berarti layanan sengaja dibuat tidak tersedia atau sedang kelebihan beban, dan 504 berarti back end sama sekali tidak menjawab sebelum waktu tunggu gateway habis.
Perbedaan ini penting karena menentukan apa yang sebaiknya Anda lakukan. Error 503 sering disertai petunjuk Retry-After dan pulih sesuai jadwal. Error 504 menandakan respons yang lambat, jadi solusinya adalah menunggu atau mengatur ulang batas waktu. Error 502 menandakan adanya crash, port yang salah, atau balasan yang rusak, sehingga perlu ditangani oleh orang di sisi server.
| Kode | Yang dilihat gateway | Siapa yang biasanya memperbaikinya | Yang bisa dilakukan pengunjung |
|---|---|---|---|
| 500 Internal Server Error | Aplikasinya sendiri mengalami error | Pengembang situs | Muat ulang sekali, lalu tunggu |
| 502 Bad Gateway | Balasan yang tidak valid atau kosong dari server upstream | Admin situs (proxy atau aplikasi) | Muat ulang, coba di jaringan lain, lalu tunggu |
| 503 Service Unavailable | Layanan menyatakan sedang tidak aktif atau kelebihan beban | Admin situs, sering kali sengaja saat pemeliharaan | Tunggu sampai batas waktu Retry-After berakhir |
| 504 Gateway Timeout | Tidak ada balasan sama sekali dalam batas waktu gateway | Admin situs (back end lambat atau pengaturan batas waktu) | Tunggu beberapa menit, lalu coba lagi |
Yang bisa Anda lakukan saat melihat error HTTP 502 sebagai pengunjung
Muat ulang sekali setelah jeda singkat, lalu coba buka halaman yang sama dari jaringan lain. Jika keduanya gagal, berarti situsnya sedang mati dan tidak ada pengaturan di perangkat Anda yang bisa mengubahnya.
Menurut kami, kebanyakan pengunjung terlalu rumit mendiagnosis error 502. Saran jujur kami: tunggu tiga menit sebelum mengubah pengaturan apa pun, karena proses yang crash di sisi situs biasanya dimulai ulang oleh sistem pemantauannya sendiri dalam waktu itu. Langkah-langkah di bawah ini untuk sebagian kecil kasus ketika error muncul karena perangkat atau jaringan Anda.
Muat ulang setelah menunggu sebentar
Hitung sampai tiga puluh lalu tekan muat ulang. Error 502 dari back end yang sedang restart sering hilang pada percobaan kedua atau ketiga.
Coba jaringan lain
Buka alamat yang sama di ponsel Anda lewat data seluler. Jika error 502 juga muncul di sana, hentikan pemecahan masalah: ini masalah di pihak situs.
Bersihkan cache DNS Anda
Di Windows, buka Terminal sebagai administrator lalu jalankan ipconfig /flushdns, kemudian netsh winsock reset, seperti yang disarankan dalam jawaban komunitas Microsoft tanggal 20 April 2026. Entri DNS yang usang bisa mengarahkan Anda ke gateway yang sudah tidak berfungsi dengan baik.
Ganti server VPN atau matikan VPN untuk menguji
Jika Anda memakai VPN, pilih server di negara lain lalu muat ulang halaman. Jika hasilnya berubah, berarti satu lokasi edge sedang bermasalah, bukan perangkat Anda. Nyalakan kembali VPN setelahnya jika Anda membutuhkannya.
Periksa halaman status atau akun media sosial situs
Layanan besar biasanya mengumumkan gangguan dalam hitungan menit. Jika mereka menulis 'sedang diselidiki', tutup tab dan kembali lagi nanti.
Hapus cookie untuk situs itu saja
Jarang terjadi, tetapi cookie sesi yang rusak bisa membuat gateway autentikasi menolak permintaan dan mengirim error 502. Hapus cookie untuk satu domain itu saja, bukan seluruh browser Anda.
Jika Anda mengelola situs, tiga perbaikan ini biasanya mengatasi sebagian besar error 502
Mulai ulang upstream yang mati, arahkan proxy ke port yang benar, dan naikkan batas waktu baca proxy. Menurut Authgear, sembilan dari sepuluh kasus disebabkan oleh salah satu dari ketiga hal itu.
Selain ketiga hal itu, penyebab yang sering ditemui adalah load balancer yang health check-nya menandai semua backend tidak sehat, proxy yang menyimpan jawaban DNS lama untuk upstream, TLS handshake yang gagal antara proxy dan upstream, atau upstream yang kehabisan memori atau proses worker. Masing-masing meninggalkan catatan di log error proxy, jadi baca log itu sebelum mengubah konfigurasi.
Pastikan aplikasi sedang mendengarkan
Jalankan ss -tlnp | grep <port> di server. Jika tidak ada yang mendengarkan di port yang diharapkan proxy, jalankan aplikasinya dan cari tahu mengapa aplikasi itu mati.
Periksa tujuan proxy
Di Nginx, lihat proxy_pass; di Apache, lihat ProxyPass. Port yang salah, path socket yang salah, atau http:// padahal aplikasi memakai https:// hampir pasti menimbulkan error 502.
Bandingkan batas waktu dengan waktu respons sebenarnya
Jika aplikasi memang lambat, naikkan proxy_read_timeout (Nginx) atau ProxyTimeout (Apache), lalu lakukan profiling pada endpoint yang lambat agar batas waktu tidak menutupi bug.
Coba ulangi dengan curl dari host proxy
curl -v http://127.0.0.1:<port>/ dari mesin yang sama akan menunjukkan apakah upstream menjawab sama sekali dan apakah header-nya berupa HTTP yang valid.
Periksa kondisi load balancer
Pada AWS ALB, Kubernetes Ingress, atau layanan serupa, target group yang tidak punya backend sehat akan mengembalikan 502 untuk semua orang. Perbaiki path health check atau respons readiness aplikasi.
VPN jarang menjadi penyebab error 502, tetapi satu server keluar bisa mengarahkan Anda ke edge yang bermasalah
VPN tidak menimbulkan error 502 dengan sendirinya. MDN menyebut VPN dan pengaturan jaringan khusus lainnya sebagai pengecualian yang perlu diperiksa hanya jika situs berjalan normal bagi orang lain.
Inilah alasan mengapa berganti server kadang membantu. Situs besar menjawab dari CDN edge yang paling dekat dengan alamat IP keluar Anda. Jika edge tersebut, atau jalurnya kembali ke origin, sedang bermasalah, semua orang yang keluar lewat jalur itu akan melihat 502, sementara orang di tempat lain bisa membuka situs seperti biasa. Memilih server di negara lain akan mengarahkan Anda ke edge yang berbeda. Ini adalah cara pengujian yang wajar, bukan trik. Anda bisa memastikan jalur keluar yang dipakai di tealvpn.com/what-is-my-ip sebelum dan sesudah berganti server.
Teal VPN, dibuat oleh Fxolio LLC, punya paket Gratis (500 MB per hari) dan paket Pro, dengan aplikasi untuk Android, Windows, Mac, Linux, Android TV, dan Chromebook, serta server di 14 negara per November 2026. Teal Secure aktif untuk setiap koneksi dan setiap paket: fitur ini menyamarkan lalu lintas VPN, dan aplikasi mencoba jalur lain secara otomatis saat sebuah jaringan menutup salah satu jalur. Itu membantu di jaringan yang membatasi VPN, tetapi tidak berpengaruh pada error 502, karena 502 berarti back end situs itu sendiri sedang gagal. Tidak ada VPN yang dijamin bisa terhubung di semua jaringan, dan tidak ada VPN yang bisa memperbaiki server milik pihak lain.
- Sebelum menyalahkan VPN: apakah 502 tetap muncul saat VPN dimatikan, di jaringan yang sama?
- Apakah error muncul juga di server negara kedua?
- Apakah halaman error menampilkan nama CDN (Cloudflare, Fastly), bukan nama situs tersebut?
- Apakah teman di luar jaringan Anda mendapat error yang sama dalam menit yang sama?
Pemilik situs bisa mencegah 502 berulang dengan health check dan batas waktu (timeout) yang realistis
Error 502 yang berulang akan berhenti jika proxy mengetahui kondisi aplikasi yang sebenarnya: endpoint kesiapan yang dipanggil oleh health check, process manager yang menjalankan ulang aplikasi saat crash, dan batas waktu proxy yang ditentukan dari waktu respons yang diukur, bukan sekadar perkiraan.
Ada dua kebiasaan lain yang berguna. Pertama, atur cache DNS proxy untuk upstream agar singkat, sehingga saat aplikasi di-deploy ulang ke alamat baru, proxy tidak tetap menuju alamat lama. Kedua, pasang peringatan pada jumlah error 502 itu sendiri, bukan hanya pada CPU atau memori, karena baris proxy_pass yang salah menghasilkan beban nol tetapi tingkat error seratus persen.
Baca lebih lanjut
Referensi
- 502 Bad Gateway - HTTP | MDN
- HTTP 502 Bad Gateway: Penyebab & Solusi | Authgear
- bagaimana bisa muncul 502 - Microsoft Q&A
Butuh bantuan dengan Teal VPN? Hubungi dukungan.
Pertanyaan
Apa arti error HTTP 502?
Artinya server yang bertindak sebagai gateway atau proxy menerima respons yang tidak valid, atau tidak menerima respons yang bisa dipakai, dari server di belakangnya. Gateway-nya baik-baik saja; server aplikasinya tidak menjawab dengan benar.
Apakah error HTTP 502 disebabkan oleh saya?
Hampir tidak pernah. Ini kode 5xx, yang menurut definisinya berasal dari sisi server. Coba di jaringan lain; jika 502 muncul juga di sana, berarti masalahnya ada di situs tersebut dan yang bisa dilakukan hanyalah menunggu.
Berapa lama error 502 berlangsung?
Sering kali hanya beberapa detik sampai beberapa menit, karena sistem pemantauan akan menjalankan ulang proses yang berhenti. Jika berlangsung lebih dari lima belas menit, admin situs kemungkinan menghadapi masalah konfigurasi, bukan sekadar crash, dan hanya mereka yang bisa memperbaikinya.
Apa perbedaan antara 502 dan 504?
502 berarti back end membalas dengan sesuatu yang tidak valid; 504 berarti back end tidak membalas sama sekali sebelum batas waktu gateway habis. MDN membedakannya persis seperti itu: jika server asal tidak memberi respons HTTP, hasilnya 504; jika responsnya buruk, hasilnya 502.
Apakah VPN bisa memperbaiki error HTTP 502?
Hanya dalam kasus yang sempit, yaitu ketika satu edge CDN di dekat IP keluar Anda sedang bermasalah. Berpindah ke server Teal VPN di negara lain akan mengarahkan Anda ke edge yang berbeda; jika error tetap muncul, berarti back end situs sedang mati dan VPN apa pun tidak akan membantu.
Mengapa Zoom atau sebuah game menampilkan error HTTP 502?
Aplikasi berkomunikasi dengan jenis gateway yang sama seperti situs web. Saat back end layanan mengalami crash atau kelebihan beban, gateway aplikasi mengembalikan kode 502 dan aplikasi menampilkannya sebagai 'HTTP error! status: 502' atau pesan kesalahan server umum.
Apa arti kode 502 dari ngrok?
Tunnel sudah sampai ke komputer Anda, tetapi tidak ada yang merespons di port lokal yang Anda tentukan untuk diteruskan oleh ngrok. Jalankan aplikasi lokal di port tersebut, atau perbaiki port pada perintah ngrok.