Nginx 502 Bad Gateway 오류 해결 방법 - 6가지 원인 분석 및 대처법

# Nginx 에러 로그 (가장 먼저)
sudo tail -50 /var/log/nginx/error.log

# 특정 도메인 로그가 따로 있다면
sudo tail -50 /var/log/nginx/도메인.error.log

# Node.js 앱인 경우
sudo systemctl status myapp
pm2 status

# PHP-FPM 인 경우
sudo systemctl status php8.2-fpm    # 버전 확인 후

# Gunicorn (Python) 인 경우
sudo systemctl status gunicorn

# 실제 포트가 열려 있는지 확인
sudo ss -tlnp | grep 3000   # 포트 번호에 맞게

# Nginx 설정에서 upstream 주소 확인
sudo grep -rn "proxy_pass|fastcgi_pass|uwsgi_pass" /etc/nginx/

# 예: proxy_pass가 3000인데 앱은 8080으로 실행 중
proxy_pass http://127.0.0.1:3000;   # ← 실제 앱 포트와 일치해야 함

# 앱이 실제로 어느 포트에서 듣는지 확인
sudo ss -tlnp | grep LISTEN

# 실제 소켓 파일 위치 확인
sudo find /run/php/ -name "*.sock" 2>/dev/null
ls /var/run/php/

# PHP-FPM pool 설정에서 실제 소켓 경로 확인
sudo grep "listen" /etc/php/8.2/fpm/pool.d/www.conf

# /etc/nginx/sites-available/mysite
fastcgi_pass unix:/run/php/php8.2-fpm.sock;   # 실제 소켓 경로로 수정

sudo nginx -t && sudo systemctl reload nginx

# /etc/nginx/conf.d/timeout.conf 또는 server 블록 안
proxy_connect_timeout  60s;
proxy_send_timeout     120s;
proxy_read_timeout     120s;   # 이 값을 늘려야 함

sudo nginx -t && sudo systemctl reload nginx

# 소켓 파일 소유자·권한 확인
ls -la /run/app.sock

# Nginx 워커 프로세스 실행 유저 확인
sudo grep "^user" /etc/nginx/nginx.conf
# 보통 www-data 또는 nginx

# 소켓 파일 권한 수정
sudo chown www-data:www-data /run/app.sock
# 또는 그룹 쓰기 허용
sudo chmod 660 /run/app.sock

# OOM Killer 로그 확인
sudo dmesg | grep -i "oom|killed process" | tail -10
sudo journalctl -k | grep -i oom | tail -10

# 현재 메모리 상태
free -h

# 1. 에러 로그 확인
sudo tail -30 /var/log/nginx/error.log

# 2. upstream 프로세스 상태
sudo systemctl status php8.2-fpm    # 또는 해당 서비스

# 3. 실제 포트/소켓 리스닝 여부
sudo ss -tlnp

# 4. Nginx 설정 검증
sudo nginx -t

# 5. 설정 반영
sudo systemctl reload nginx