의미
게이트웨이나 프록시가 요청을 전달한 업스트림 서버로부터 잘못된 응답을 받았습니다.
흔한 원인
- 앱 서버가 다운되었거나 수신 대기하지 않음(잘못된 포트나 소켓)
- 업스트림이 연결을 닫거나 잘못된 헤더를 보냄
- PHP-FPM, Gunicorn, Node 프로세스 재시작
해결 방법
클라이언트 또는 방문자라면
잠시 후 재시도하세요. 보통 일시적입니다. 계속되면 사이트 백엔드가 다운된 것입니다.
사이트나 API 운영자라면
업스트림 프로세스가 실행 중이고 프록시가 쓰는 주소에서 수신 대기하는지 확인하고, 프록시 오류 로그에서 정확한 업스트림 오류를 읽으세요.
응답 예시
HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0명세
자주 묻는 질문
› nginx의 502 Bad Gateway를 해결하려면?
업스트림(앱이 실행 중인지, proxy_pass 주소/소켓이 맞는지)과 nginx 오류 로그를 확인하고, 앱 서버가 죽었다면 재시작하세요.
› 502와 504의 차이는?
502: 업스트림이 엉뚱한 응답을 하거나 연결을 닫음. 504: 업스트림이 제때 응답하지 않음.