HTTP 502 Bad Gateway
502는 서버 오류(5xx) 응답이에요. 아래 숫자를 바꿔 다른 코드도 바로 찾아볼 수 있어요.
파일은 서버로 전송되지 않고 내 기기에서만 처리돼요
HTTP 상태 코드 · 5xx 서버 오류
502 Bad Gateway
잘못된 게이트웨이 — 게이트웨이나 프록시가 뒤쪽(업스트림) 서버에서 잘못된 응답을 받았다는 뜻이에요.
| 이름 | 502 Bad Gateway |
|---|---|
| 분류 | 5xx 서버 오류 |
| 정의 문서 | RFC 9110 §15.6.3 |
| 기본 캐시 | 명시적 캐시 지시가 있을 때만 |
| 관련 헤더 | 특별히 정한 헤더 없음 |
응답 예시
HTTP/1.1 502 Bad Gateway Date: Thu, 12 Nov 2026 03:00:00 GMT
다른 상태 코드 찾아보기
HTTP 502 Bad Gateway 뜻
502 Bad Gateway(잘못된 게이트웨이)는 5xx 서버 오류 응답이에요. 5xx는 서버가 올바른 요청을 처리하지 못했다는 응답이에요. 게이트웨이나 프록시가 뒤쪽(업스트림) 서버에서 잘못된 응답을 받았다는 뜻이에요. 정의는 HTTP 의미론 표준인 RFC 9110의 15.6.3절에 있어요.

캐시: RFC 9110은 200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414, 501을 ‘기본으로 캐시 가능(heuristically cacheable)’으로 정해요. 502는 이 목록에 없어서, 응답에 Cache-Control이나 Expires로 캐시를 허락해야만 저장돼요.
사용자로서 이 코드를 봤다면
사이트 서버가 잠시 불안정해요. 조금 뒤 다시 시도하세요.
개발자라면
리버스 프록시 뒤의 앱 서버가 죽었거나 비정상 응답을 줄 때 생겨요.
같은 분류의 다른 코드
| 코드 | 이름 | 한국어 | 기본 캐시 |
|---|---|---|---|
| 500 | Internal Server Error | 서버 내부 오류 | - |
| 501 | Not Implemented | 구현되지 않음 | 가능 |
| 503 | Service Unavailable | 서비스 이용 불가 | - |
| 504 | Gateway Timeout | 게이트웨이 시간 초과 | - |
| 505 | HTTP Version Not Supported | HTTP 버전 미지원 | - |
| 506 | Variant Also Negotiates | 변형도 협상 중 | - |
| 507 | Insufficient Storage | 저장 공간 부족 | - |
| 508 | Loop Detected | 반복 감지 | - |
| 510 | Not Extended | 확장 필요(폐지) | - |
| 511 | Network Authentication Required | 네트워크 인증 필요 | - |
이어서 보기
참고한 자료
- IANA Hypertext Transfer Protocol (HTTP) Status Code Registry (등록 이름·참조 문서, 확인 2026-11-12)
- RFC 9110 HTTP Semantics — 15. Status Codes (정의·필수 헤더·기본 캐시 가능 코드, 확인 2026-11-12)
자주 묻는 질문
HTTP 502 오류는 무슨 뜻이에요?
잘못된 게이트웨이라는 뜻의 5xx 서버 오류 응답이에요. 게이트웨이나 프록시가 뒤쪽(업스트림) 서버에서 잘못된 응답을 받았다는 뜻이에요.
502 응답은 캐시되나요?
기본으로 캐시 가능한 코드가 아니라서 Cache-Control 같은 지시가 있어야 캐시돼요.
502와 504의 차이는요?
502는 뒤쪽 서버에서 잘못된 응답을 받은 경우, 504는 제때 응답을 받지 못한 경우예요.
함께 쓰면 좋은 도구
- JSON 정리 (보기 좋게 들여쓰기·검증·압축)JSON을 보기 좋게 들여쓰기, 오류 위치 표시, 한 줄 압축, 키 정렬, 문자열 이스케이프
- 메타 태그 만들기 (SEO·오픈그래프·카톡 공유 미리보기)제목·설명·대표 이미지로 SEO·오픈그래프·트위터 카드 태그를 만들고, 검색·카톡 공유 미리보기 확인
- 정규식 테스트 (정규표현식 매칭 확인)패턴과 플래그로 일치하는 부분을 강조 표시, 그룹 값 표, 바꾸기 미리보기, 자주 쓰는 패턴
- Base64 인코딩·디코딩 (글자·파일 ↔ Base64)글자(한글 UTF-8)를 Base64로, Base64를 글자로, 파일·이미지를 data URI로, Base64를 파일로 저장
- 색상 코드 변환 (HEX·RGB·HSL·CMYK)HEX·RGB·HSL·HSV·CMYK를 서로 바꾸고, 글자 대비(WCAG) 검사, 밝게·어둡게 단계 표
- 색상 팔레트 만들기 (어울리는 색 조합·사진에서 색 뽑기)대표 색 하나로 보색·유사색·삼각 배색·단계색 팔레트, 사진에서 주요 색 뽑기, CSS·PNG로