인프라 · 문제 해결 가이드

502 Bad Gateway 또는 504 Gateway Timeout이 보여요

502 또는 504 오류 화면이 보일 때, 표시된 상태 코드와 응답 주체를 기준으로 업스트림 응답 오류와 시간 초과 확인 문서를 고릅니다.

대상: 사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
최종 검토: 2026-07-27
참고 자료: 있음

빠른 답변

502 또는 504가 보이면 오류 코드, 전체 URL, 발생 시각, 응답 주체를 먼저 기록한 뒤 502는 업스트림의 유효하지 않은 응답을, 504는 업스트림 응답 시간과 시간 제한을 확인해야 합니다.

이 가이드가 맞는 경우

애플리케이션 오류 메시지
사이트 접속 불가

상황별 다음 단계

HTTP 502: Bad gateway

오류 화면 또는 HTTP 응답에 502 Bad Gateway가 표시됩니다.

HTTP 504: Gateway timeout

오류 화면 또는 HTTP 응답에 504 Gateway Timeout이 표시됩니다.

호스팅사·개발자에게 전달할 내용

변경 전 기록

오류가 난 전체 URL, 상태 코드, 발생 시각과 응답 헤더를 전달합니다.
프록시·로드 밸런서·원본 서버 로그에서 같은 시각의 요청 ID 또는 오류 문구를 전달합니다.
최근 배포, DNS, CDN, 프록시, 시간 제한 변경 내용을 전달합니다.

알아둘 점

502 Bad Gateway와 504 Gateway Timeout은 모두 프록시·게이트웨이·로드 밸런서를 거치는 요청에서 보일 수 있지만 같은 상태가 아닙니다. 상태 코드, 전체 URL, 발생 시각, 응답 주체를 기록한 뒤 위에서 같은 오류 코드를 고르세요.