Error 502 Bad Gateway muncul ketika server perantara (gateway atau proxy) menerima respons yang tidak valid atau kosong dari server utama (upstream server atau backend application) saat memproses permintaan website.
I. Diagnosis Cepat (Sisi Klien)
Lakukan langkah-langkah berikut untuk memastikan masalah bukan disebabkan oleh perangkat atau koneksi Anda:
- Muat Ulang (Refresh): Tekan F5 atau Ctrl + F5. Error 502 seringkali hanya bersifat sementara (temporary overload) dan dapat teratasi dengan refresh.
- Bersihkan Cache: Bersihkan cache dan cookies browser Anda atau coba akses situs di Incognito Mode.
- Flush DNS Lokal: Jika Anda baru saja mengganti Nameserver atau hosting, lakukan flush DNS pada komputer Anda untuk memperbarui cache IP lokal.
- Nonaktifkan CDN: Jika Anda menggunakan layanan CDN (seperti Cloudflare), coba nonaktifkan layanan tersebut untuk sementara waktu (atau pause) untuk memastikan CDN bukan penyebabnya.
II. Solusi Utama (Sisi Hosting)
Jika masalah 502 terus berlanjut setelah langkah-langkah klien, masalahnya ada di hosting Anda:
1. Konflik Plugin / Script Berat
Pada CMS (seperti WordPress), script atau query yang terlalu berat dapat menyebabkan proses PHP dimatikan oleh server karena melampaui batas waktu, yang menghasilkan respons invalid (502).
- Aksi: Akses File Manager dan ubah nama folder /wp-content/plugins/ menjadi /plugins_OFF/.
- Verifikasi: Jika situs kembali normal, segera aktifkan plugin satu per satu untuk menemukan plugin yang memicu Error 502.
2. Batas PHP Timeout (FastCGI Timeout)
Meskipun max_execution_time diatur tinggi, server proxy (Nginx/LiteSpeed) mungkin memiliki batas waktu koneksi (FastCGI Timeout) yang lebih pendek.
- Aksi: Tingkatkan nilai batas waktu eksekusi PHP Anda. Ikuti panduan Cara Mengubah Nilai max_execution_time dan max_input_time di Control Panel Anda.
- Solusi Tambahan: Jika setelah menaikkan batas waktu PHP error tetap ada, ini mengindikasikan batas FastCGI di server. Lanjutkan ke Langkah 4.
3. Periksa Log Error Server
Untuk aplikasi kustom (Node.js/Python/Laravel), Error 502 terjadi jika aplikasi backend Anda berhenti bekerja atau crash.
- Aksi: Periksa Error Log di Control Panel Anda untuk melihat apakah ada crash pada proses PHP-FPM, Node.js, atau aplikasi backend lainnya.
III. Langkah Akhir (Hubungi Support)
Error 502 yang persisten seringkali memerlukan intervensi root untuk memeriksa konfigurasi Nginx/LiteSpeed atau Firewall.
- Buat Ticket: Segera ajukan Tiket Bantuan (Support Ticket) melalui Client Area Anda.
- Sertakan Detail: Informasikan bahwa Anda sudah mencoba menonaktifkan plugin dan menaikkan batas waktu PHP.
- Tim teknis akan memeriksa load server dan konfigurasi proxy untuk menyelesaikan timeout antara gateway dan server backend Anda.