개발자 참고 자료

HTTP 상태 코드뜻과 점검 순서

번호나 문구를 찾고 응답 범주로 좁힌 뒤 출처와 점검 지점을 확인하세요.

번호 또는 이름

검색 결과

1xx 정보

2xx 성공

3xx 리디렉션

4xx 클라이언트 오류

5xx 서버 오류

선택한 응답

502 Bad Gateway

5xx 서버 오류

의미: 게이트웨이나 프록시가 잘못된 상위 응답을 받았습니다.

흔한 상황: 상위 연결 또는 응답이 깨졌습니다.

먼저 확인할 것: 프록시 로그와 상위 서버 상태를 보고 504 시간 초과와 구분하세요.

HTTP 응답 예시

가상의 HTTP/1.1 예시입니다. 실제 헤더와 본문은 서버마다 다릅니다.

HTTP/1.1 502 Bad Gateway
Content-Type: application/problem+json

{"title":"Bad Gateway","status":502}

정의 RFC IANA 등록부

검색은 브라우저에 포함된 자료만 거릅니다. 출처나 도구 링크를 열기 전에는 외부 요청이 없습니다.

응답 범주

선별된 28개 중 28개 · 현재 502

IANA 등록부 최종 갱신: 2025년 9월 15일자료 확인일: 2026년 9월 23일

응답 헤더 살펴보기

API 로그에 숫자 하나만 남았다면 요청, 게이트웨이, 원본 서버 중 어디부터 살펴볼지 막막할 수 있습니다. 이 HTTP 상태 코드 자료는 프로토콜 의미와 응답 예시를 첫 점검 지점에 연결합니다.

HTTP 상태 코드는 조사 방향을 알려 줄 뿐 원인을 확정하지 않습니다. 실제 헤더와 본문, 서버 로그를 확인하세요. 이 페이지는 일부 항목을 선별한 자료이며 실시간 진단은 하지 않습니다.

HTTP 상태 코드를 함께 살펴봐야 하는 이유

숫자만으로는 원인이 정해지지 않습니다. 응답이 생긴 위치에 따라 다음 점검도 달라집니다.

잘못된 응답과 지연을 구별

HTTP 상태 코드 502는 게이트웨이가 잘못된 상위 응답을 받은 경우이고 504는 제때 응답을 받지 못한 경우입니다. 둘 다 중간 서버가 반환할 수 있지만 점검 방향은 다릅니다.

한 경로에서는 깨진 상위 응답이 내려오고 다른 경로에서는 시계가 시간을 넘기는 두 게이트웨이 그림

검색 결과에서 근거 확인

429를 찾으면 Retry-After 헤더 예시와 먼저 볼 항목이 나옵니다. 선택한 HTTP 상태 코드마다 정의 RFC와 IANA 등록부로 이동할 수도 있습니다.

참고 카드 더미가 검색으로 한 장으로 좁혀지고 재시도 시계와 확인 목록이 보이는 그림

코드만 보고 바로 다시 요청하지 않기

번호와 뜻으로 찾기

검색어를 비우면 선별된 28개가 보입니다. 번호, 영어 이유 문구, 한국어 의미를 검색하고 다섯 범주로 제출한 결과를 좁힐 수 있습니다.

비슷한 결과 비교

기본 502와 504는 잘못된 응답과 시간 초과를 구분합니다. 429 예시는 Retry-After를 보여 주며 302와 307은 요청 메서드 처리에서 다릅니다.

실제 통신으로 확인

예시는 가상의 HTTP/1.1 응답입니다. RFC와 실제 헤더, 로그를 대조하세요. 검색되지 않는 번호도 이 선별 목록 밖에 있을 수 있습니다.

선별 항목마다 확인할 세 가지

다섯 범주 로컬 검색

상태 코드 목록의 28개 항목을 번호, 영어 이름, 한국어 뜻으로 찾습니다. 모든 세 자리 숫자를 유효한 코드로 취급하지 않습니다.

응답 형식과 핵심 헤더

204와 304 예시에는 본문이 없고 401, 405, 429에는 판단에 도움이 되는 인증, 허용 메서드, 재시도 헤더가 있습니다.

정의로 바로 이동

RFC와 IANA 링크를 통해 HTTP 응답 상태 코드의 규약 의미를 앱 내부 오류와 구분할 수 있습니다.

자료의 범위와 해석 한계

전체 목록이 아닌 28개: 목록에 없는 플랫폼 전용 번호도 무효라고 단정하지 않습니다. 전체 등록 상태는 IANA에서 확인하세요. 코드별 독립 페이지도 만들지 않습니다.
실시간 진단은 하지 않음: HTTP 오류 코드 조회는 정적 자료만 이용하며 URL을 검사하거나 로그를 읽지 않습니다. 502 하나만으로 CDN, 프록시, 원본 중 원인을 특정할 수 없습니다.
예시는 실제 패킷이 아님: 화면에는 가상의 HTTP/1.1 텍스트를 표시합니다. HTTP/2와 HTTP/3의 실제 전송 형식 및 응답 본문은 다를 수 있습니다.
재시도는 별도 판단: 429나 503에 Retry-After가 있어도 쓰기 요청의 안전한 재전송 여부는 멱등성과 서비스 정책에 달려 있습니다.

HTTP 상태 코드 자주 묻는 질문

HTTP 상태 코드는 어떤 범주로 나뉘나요?

1xx 정보, 2xx 성공, 3xx 리디렉션, 4xx 클라이언트 오류, 5xx 서버 오류로 나뉩니다. 이 HTTP 상태 코드 자료는 28개를 선별했고 전체 등록부는 각 상세 화면에서 열 수 있습니다.

401과 403은 어떻게 다른가요?

401은 유효한 인증 정보가 없다는 뜻이며 WWW-Authenticate를 확인해야 합니다. 403은 서버가 요청을 이해했지만 거부한 것으로 인증된 사용자도 권한이 없을 수 있습니다.

404와 410은 언제 구분해서 쓰나요?

404는 현재 리소스를 찾지 못했다는 뜻으로 영구 삭제 여부를 말하지 않습니다. 영구적으로 없어졌음을 알고 있다면 410이 더 구체적입니다.

429 응답을 받으면 어떻게 해야 하나요?

Retry-After가 있는지 보고 서비스의 요청 제한 정책을 확인하세요. 쓰기 작업은 재시도가 안전한지 따로 판단해야 합니다.

502와 504는 어떻게 다른가요?

502는 게이트웨이가 잘못된 상위 응답을 받은 경우, 504는 제한 시간 안에 응답을 받지 못한 경우입니다. 실제 원인은 프록시와 상위 서버 로그로 확인합니다.

빠진 코드나 점검 항목이 있나요?

HTTP 상태 코드 살펴보기

코드를 찾고 예시를 실제 헤더와 대조한 다음 정의 문서를 확인하세요.

코드 찾기 카테고리 보기

HTTP 상태 코드뜻과 점검 순서