🌐 KO

🔢 HTTP 상태 코드 참조표

1xx(정보)부터 5xx(서버 오류)까지 표준 HTTP 상태 코드 전체를 분류별로 정리했습니다. 각 코드의 공식 사유구(reason phrase), 한 줄 설명, 근거 RFC 조항을 함께 볼 수 있고, 코드 번호·문구·설명으로 실시간 검색이 가능합니다.

가이드

자세히 알아보기

01

1. HTTP 상태 코드 5개 분류

HTTP 상태 코드는 첫 자리 숫자로 5개 클래스로 나뉩니다: 1xx(정보성 응답, 요청 처리가 계속 진행 중임을 알림), 2xx(성공, 요청이 정상적으로 접수·처리·이해됨), 3xx(리다이렉션, 요청을 완료하려면 추가 동작이 필요함), 4xx(클라이언트 오류, 요청 자체에 문제가 있음), 5xx(서버 오류, 서버가 유효한 요청을 처리하는 데 실패함). 클라이언트나 프록시는 이 첫 자리만 봐도 알지 못하는 코드에 대해 대략적인 대응을 할 수 있도록 설계되었습니다.

02

2. 헷갈리기 쉬운 코드 쌍

401 Unauthorized는 실제로는 "인증되지 않음"을 뜻하며(이름과 달리 인가가 아니라 인증 문제), 403 Forbidden은 인증 여부와 무관하게 권한이 없어 거부되는 경우입니다. 301/308(영구)과 302/307(임시)의 차이는 캐싱·SEO에 중요하며, 특히 307/308은 메서드와 본문을 그대로 유지한 채 리다이렉트한다는 점에서 302/301과 구분됩니다. 404 Not Found와 410 Gone도 자주 혼동되는데, 410은 "예전엔 있었지만 의도적으로 영구히 삭제됨"을 명시적으로 알려 클라이언트가 재시도를 멈추도록 하는 강한 신호입니다.

03

3. RFC 9110과 상태 코드의 표준화

2022년 발행된 RFC 9110(HTTP Semantics)은 기존 RFC 7231 등에 흩어져 있던 HTTP 상태 코드 정의를 통합·정리한 최신 표준입니다. 이 표는 RFC 9110의 조항 번호(§15.x)를 우선 인용하고, WebDAV(RFC 4918)나 확장 상태 코드(RFC 6585 등 429/431 Too Many Requests 계열)처럼 별도 RFC로 정의된 코드는 해당 RFC를 표기합니다. 실무에서 상태 코드를 정확히 사용하면 API 클라이언트, 모니터링 도구, 캐시 서버가 예측 가능하게 동작할 수 있습니다.

자주 묻는 질문

이 참조표에 없는 상태 코드가 있나요?
IANA 공식 등록부에 있는 표준 상태 코드는 모두 포함했습니다. 특정 프레임워크나 CDN이 비표준 코드를 반환하는 경우는 이 표에 없을 수 있습니다.
검색은 어떻게 동작하나요?
입력한 문자열이 코드 번호, 영문 사유구, 설명 중 어디에라도 포함되면(대소문자 무시) 그 행이 표시됩니다. 예: "404"나 "not found"나 "찾을 수 없음"의 일부로 검색 가능합니다.
422와 400의 차이는 무엇인가요?
400은 요청 자체의 구문이 잘못된 경우, 422는 구문은 올바르지만 그 안의 지시(예: 유효성 검증 실패)를 의미상 처리할 수 없는 경우에 씁니다.
이 데이터는 어디서 처리되나요?
전체가 정적 참조 데이터이며 검색도 브라우저 자바스크립트 안에서만 이루어집니다. 서버로 전송되는 것이 없습니다.