502서버 오류(5xx)
502 Bad Gateway — 게이트웨이 오류
게이트웨이/프록시가 상위(업스트림) 서버로부터 잘못된 응답을 받았다는 응답입니다. 앞단은 멀쩡한데 뒷단이 문제일 때 납니다.
언제 발생하나
리버스 프록시(Nginx) 뒤의 앱이 죽거나, 서버리스 함수가 비정상 응답·크래시, 업스트림 연결 실패 시 발생합니다.
실무 대응
- 업스트림(앱 서버·함수)이 실제로 떠 있고 정상 응답하는지 먼저 확인합니다.
- 함수 크래시(메모리 초과·미처리 예외)인지 로그를 확인합니다.
- 프록시의 업스트림 주소·포트·타임아웃 설정을 점검합니다.
💡 실무 메모: 502는 보통 "내 앱이 죽었거나 잘못된 응답을 냈다"는 신호입니다. 504(타임아웃)와 구분해 원인을 좁히세요.