Nginx 502 Bad Gateway 오류 해결: 단계별 가이드

Nginx에서 발생하는 502 Bad Gateway 오류는 업스트림 서버(예: PHP-FPM, Gunicorn, Node.js 등)가 유효하지 않은 응답을 보냈을 때 발생합니다. 이 가이드에서는 이 문제를 해결하는 방법을 단계별로 안내합니다.

1. 업스트림 서비스 상태 확인

가장 먼저 확인해야 할 것은 백엔드 서비스가 실제로 실행 중인지 여부입니다.

sudo systemctl status <service_name>

서비스가 중지되었다면 다시 시작하세요:

sudo systemctl restart <service_name>

2. Nginx 오류 로그 확인

오류의 정확한 원인을 파악하려면 Nginx 로그를 확인하는 것이 필수입니다.

sudo tail -f /var/log/nginx/error.log

3. 프록시 구성 검토

nginx.conf 또는 사이트 설정 파일에서 proxy_pass 설정이 올바른지 확인하세요.

location / {
    proxy_pass http://127.0.0.1:8080;
}

4. 방화벽 및 권한 확인

서버 간 통신이 방화벽에 의해 차단되거나, 소켓 파일에 대한 권한 문제가 있는지 확인하십시오.