Mengatasi Error 502 Bad Gateway pada Nginx dan PHP-FPM

Error 502 berarti Nginx tidak memperoleh respons yang valid dari upstream. Pada stack PHP, upstream yang paling umum adalah PHP-FPM.

1. Cek status PHP-FPM

sudo systemctl status php8.3-fpm --no-pager
sudo systemctl restart php8.3-fpm

2. Cocokkan socket

ls -l /run/php/
rg "fastcgi_pass" /etc/nginx/sites-enabled/

Jika server menggunakan PHP 8.2, socket mungkin bernama /run/php/php8.2-fpm.sock. Nama di Nginx harus sama dengan file yang tersedia.

3. Periksa log

sudo tail -n 100 /var/log/nginx/error.log
sudo journalctl -u php8.3-fpm -n 100 --no-pager

4. Uji konfigurasi

sudo nginx -t
sudo systemctl reload nginx

Jika 502 muncul hanya saat request berat, periksa timeout, memory limit PHP, CPU, dan query database. Jangan langsung menaikkan timeout sebelum menemukan akar masalah.