Cara Mengatasi HTTP 502 dan Soft 502 pada Website
Fokus artikel ini adalah error gateway: kapan itu berarti origin bermasalah, kapan CDN atau reverse proxy menjadi sumber error, dan bagaimana langkah diagnosis yang paling efisien.
Dipublikasikan: 2026-04-02 | Diperbarui: 2026-04-04
Inti Pembahasan
- `HTTP 502` berarti gateway benar-benar mengirim status `502 Bad Gateway`.
- `Soft 502` berarti halaman menunjukkan signature upstream/gateway error walaupun status akhir bukan `502`.
- Keduanya sering berakar di reverse proxy, CDN, load balancer, atau origin yang gagal merespons sehat.
Key Takeaways
- Gateway error hampir selalu perlu dicek dari sisi reverse proxy, CDN, dan upstream origin sekaligus.
- Soft 502 berbahaya karena bisa lolos dari monitoring yang hanya membaca status code.
- Jika error hanya muncul di sebagian lokasi, curigai edge/CDN, routing, atau node upstream tertentu.
- Log proxy, health check, timeout, dan signature body error adalah sumber diagnosis utama.
Entity/Topic Tags
Tag horizontal ini merangkum entitas utama artikel tanpa membuat section terlalu panjang.
Akar Masalah yang Paling Sering
Origin Tidak Sehat
Aplikasi crash, worker habis, database berat, atau service internal gagal sehingga upstream tidak bisa memberi respons valid.
Reverse Proxy Salah Konfigurasi
Upstream host, port, timeout, atau health check di Nginx, Envoy, atau load balancer tidak sesuai.
CDN / WAF Bermasalah
CDN tidak bisa menjangkau origin, origin ditolak firewall, atau edge menampilkan halaman error kustom.
Jaringan Antar Node Buruk
Koneksi antara edge, proxy, dan origin tidak stabil sehingga gateway menerima timeout atau reset.
Langkah Diagnosa yang Disarankan
- Gunakan Website Checker untuk melihat apakah error terbaca sebagai `HTTP_502` atau `SOFT_502`.
- Cek apakah masalah terjadi di semua lokasi atau hanya pada region tertentu.
- Periksa status origin, worker aplikasi, koneksi database, dan log reverse proxy.
- Bandingkan apakah CDN, load balancer, atau WAF yang memunculkan halaman error kustom.
- Jika status bukan 502 tetapi body halaman berisi `bad gateway`, `upstream`, atau `origin unreachable`, perlakukan itu sebagai Soft 502.
Checklist Perbaikan HTTP 502
- Pastikan origin app benar-benar hidup dan port upstream terbuka.
- Naikkan timeout jika aplikasi memang butuh waktu respons lebih lama.
- Periksa error log Nginx / reverse proxy untuk upstream timeout atau connection refused.
- Cek health check load balancer agar tidak menandai origin sehat sebagai unhealthy.
Checklist Perbaikan Soft 502
- Periksa halaman error kustom CDN atau WAF yang mungkin mengembalikan status 200.
- Audit rule edge yang memodifikasi status response tetapi tetap menampilkan halaman error.
- Bandingkan hasil body, title halaman, dan signature gateway error.
- Pastikan observability tidak hanya melihat status code, tetapi juga isi body error.
FAQ
Kenapa website menampilkan 502 hanya kadang-kadang?
Biasanya karena origin overload, autoscaling lambat, connection pool habis, atau hanya satu node upstream yang error.
Apakah Soft 502 berbahaya untuk monitoring?
Ya, karena banyak monitoring sederhana hanya membaca status code. Soft 502 bisa membuat website tampak sehat padahal user melihat halaman error gateway.
Kapan harus curiga ke CDN?
Saat origin terlihat sehat dari internal, tetapi user publik melihat gateway error, terutama jika masalah hanya terjadi di region tertentu.