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

401 Unauthorized는 사실상 '미인증' 상태로, 인증 정보가 없거나 유효하지 않아 로그인이 필요하다는 뜻입니다(WWW-Authenticate 헤더 동반). 403 Forbidden은 인증은 됐지만 그 리소스에 대한 권한이 없다는 뜻이라, 재인증해도 접근할 수 없습니다.

301과 308, 302와 307의 차이는 무엇인가요?

301·302는 역사적으로 리다이렉트 시 메서드가 GET으로 바뀌는 동작이 흔합니다. 반면 308(영구)·307(임시)은 원래 메서드와 본문을 반드시 유지합니다. POST 요청을 리다이렉트하면서 메서드를 보존해야 한다면 307/308을 써야 합니다.

429가 보이면 어떻게 대응하나요?

429 Too Many Requests는 레이트 리밋 초과입니다. 응답의 Retry-After 헤더가 재시도 가능한 시점을 알려 주므로, 클라이언트는 그 값을 존중해 지수 백오프(exponential backoff)로 재시도하도록 구현하는 것이 좋습니다.

502와 504는 무엇이 다른가요?

둘 다 게이트웨이·프록시(리버스 프록시·로드밸런서)가 업스트림과 통신하다 발생합니다. 502 Bad Gateway는 업스트림에서 잘못된 응답을 받은 경우(백엔드 다운·크래시 신호)이고, 504 Gateway Timeout은 업스트림이 제때 응답하지 않은 경우(백엔드 지연 신호)입니다.

← 모든 도구

HTTP 상태 코드

HTTP 상태 코드 전체를 클래스별로 검색합니다. 실무 관점의 설명 포함.

코드	이름	설명
100	Continue	요청 헤더를 받았으니 본문을 이어서 보내라는 신호. Expect: 100-continue 와 함께 사용.
101	Switching Protocols	프로토콜 전환 수락. WebSocket 핸드셰이크(Upgrade)에서 봄.
102	Processing	WebDAV: 처리 중이니 타임아웃하지 말라는 신호 (deprecated).
103	Early Hints	본 응답 전에 preload 할 리소스 힌트(Link 헤더)를 미리 전달.
200	OK	요청 성공. 가장 일반적인 성공 응답.
201	Created	리소스 생성 성공. 보통 POST/PUT 응답이며 Location 헤더로 새 리소스 위치를 알려줌.
202	Accepted	요청을 접수했지만 처리는 아직 안 끝남. 비동기 작업 큐잉에 사용.
203	Non-Authoritative Information	프록시가 원 서버 응답을 변형해서 전달함.
204	No Content	성공했지만 응답 본문 없음. DELETE 나 저장성 PUT 응답에 흔함.
205	Reset Content	성공. 클라이언트에게 폼 등 입력 뷰 초기화를 요청.
206	Partial Content	Range 요청에 대한 부분 응답. 동영상 스트리밍·이어받기에 사용.
207	Multi-Status	WebDAV: 여러 리소스에 대한 개별 상태를 XML 로 묶어 반환.
208	Already Reported	WebDAV: 이미 앞에서 보고된 멤버라 중복 나열 생략.
226	IM Used	델타 인코딩 등 인스턴스 조작(IM)을 적용한 응답.
300	Multiple Choices	선택 가능한 표현이 여러 개. 실무에서는 드묾.
301	Moved Permanently	영구 이동. SEO 링크 주스가 승계됨. 메서드가 GET 으로 바뀔 수 있음.
302	Found	임시 이동. 역사적으로 메서드가 GET 으로 바뀌는 동작이 흔함 (원래 의도는 307).
303	See Other	다른 URI 를 GET 으로 조회하라. POST 후 결과 페이지로 보낼 때(PRG 패턴) 사용.
304	Not Modified	캐시 유효. If-None-Match/If-Modified-Since 조건 요청의 응답으로 본문 없음.
307	Temporary Redirect	임시 이동. 302 와 달리 메서드·본문을 반드시 유지.
308	Permanent Redirect	영구 이동. 301 과 달리 메서드·본문을 반드시 유지.
400	Bad Request	문법 오류 등 잘못된 요청. 파라미터 검증 실패의 기본값.
401	Unauthorized	인증 필요(사실상 '미인증'). WWW-Authenticate 헤더와 함께. 권한 부족은 403.
402	Payment Required	결제 필요. 오래 예약만 돼 있다가 최근 API 과금·pay-per-crawl 에서 실사용.
403	Forbidden	인증은 됐지만 권한 없음. 재인증해도 소용없음.
404	Not Found	리소스 없음. 존재 여부를 숨기고 싶은 403 대신 쓰기도 함.
405	Method Not Allowed	리소스는 있지만 해당 HTTP 메서드는 불허. Allow 헤더로 허용 메서드 안내.
406	Not Acceptable	Accept 계열 헤더가 요구한 표현을 만들 수 없음.
407	Proxy Authentication Required	프록시 인증 필요. 401 의 프록시 버전.
408	Request Timeout	서버가 기다리다 요청 수신을 포기함. 커넥션 재사용 타임아웃에서 흔함.
409	Conflict	리소스 현재 상태와 충돌. 중복 생성, 낙관적 잠금 버전 충돌 등.
410	Gone	영구 삭제됨. 404 와 달리 '있었는데 없어졌다'를 명시.
411	Length Required	Content-Length 헤더 필수.
412	Precondition Failed	If-Match 등 조건부 요청의 전제 조건 실패. 낙관적 동시성 제어에 사용.
413	Content Too Large	요청 본문이 서버 허용치 초과. 업로드 제한(nginx client_max_body_size 등).
414	URI Too Long	URI 가 너무 김. GET 쿼리로 과도한 데이터를 보낼 때 발생.
415	Unsupported Media Type	요청 본문의 미디어 타입을 지원하지 않음 (예: JSON 만 받는 API 에 XML).
416	Range Not Satisfiable	Range 헤더가 리소스 크기를 벗어남.
417	Expectation Failed	Expect 헤더 요구사항을 충족할 수 없음.
418	I'm a teapot	만우절 RFC 2324. 실제 구현들이 이스터에그로 사용.
421	Misdirected Request	이 서버가 처리할 수 없는 대상으로 온 요청. HTTP/2 커넥션 재사용에서 발생.
422	Unprocessable Content	문법은 맞지만 의미상 처리 불가. 필드 단위 검증 실패에 널리 사용.
423	Locked	WebDAV: 리소스가 잠겨 있음.
424	Failed Dependency	WebDAV: 의존 요청이 실패해서 이 요청도 실패.
425	Too Early	TLS early data 재전송 공격 위험이 있어 처리를 거부.
426	Upgrade Required	다른 프로토콜로 업그레이드해야 함 (Upgrade 헤더 참고).
428	Precondition Required	조건부 요청(If-Match 등)이 필수. lost update 방지.
429	Too Many Requests	레이트 리밋 초과. Retry-After 헤더로 재시도 시점 안내.
431	Request Header Fields Too Large	헤더가 너무 큼. 비대한 쿠키가 흔한 원인.
451	Unavailable For Legal Reasons	법적 사유(검열·저작권 등)로 제공 불가.
499	Client Closed Request	비공식(nginx): 서버 응답 전에 클라이언트가 연결을 끊음. 타임아웃 튜닝 단서.
500	Internal Server Error	서버 내부 오류. 처리되지 않은 예외의 기본값.
501	Not Implemented	서버가 해당 메서드/기능을 구현하지 않음.
502	Bad Gateway	게이트웨이/프록시가 업스트림에서 잘못된 응답을 받음. 백엔드 다운·크래시 신호.
503	Service Unavailable	일시적 과부하·점검 중. Retry-After 로 복구 시점 안내 가능.
504	Gateway Timeout	게이트웨이/프록시가 업스트림 응답을 제때 못 받음. 백엔드 지연 신호.
505	HTTP Version Not Supported	요청의 HTTP 버전을 지원하지 않음.
506	Variant Also Negotiates	콘텐츠 협상 설정 오류 (순환 참조).
507	Insufficient Storage	WebDAV: 저장 공간 부족.
508	Loop Detected	WebDAV: 처리 중 무한 루프 감지.
510	Not Extended	요청에 추가 확장이 필요함 (거의 안 쓰임).
511	Network Authentication Required	네트워크 접속 인증 필요. 공용 와이파이 captive portal 에서 봄.

RFC 9110 표준 코드와 실무에서 자주 만나는 비공식 코드(499 등)를 포함합니다.

출처와 선별 기준

HTTP 상태 코드의 표준 정의는 RFC 9110(HTTP Semantics)과 IANA HTTP Status Code Registry 에 있습니다. 이 표의 설명은 표준 문구를 옮긴 것이 아니라 각 코드를 실무에서 언제 만나고 무엇과 혼동하기 쉬운지(예: 401 과 403, 301 과 308) 를 기준으로 새로 쓴 것입니다. 표준에 없지만 실제로 자주 보는 비공식 코드(nginx 의 499 등)도 그 사실을 밝히고 포함했습니다. 규범적 정의는 아래 원문을 따르세요.

HTTP 상태 코드 레퍼런스란?

이 도구는 HTTP 응답 상태 코드를 코드·이름·실무 설명과 함께 정리한 검색 가능한 레퍼런스입니다. RFC 9110의 표준 코드는 물론, 실무에서 자주 마주치는 비공식 코드(예: nginx의 499 Client Closed Request)까지 포함해 100번대부터 500번대까지 한 곳에서 찾아볼 수 있습니다.

상태 코드는 앞자리로 성격이 나뉩니다. 1xx는 정보성, 2xx는 성공, 3xx는 리다이렉션, 4xx는 클라이언트 오류, 5xx는 서버 오류입니다. 각 코드에는 단순한 사전적 정의가 아니라 '언제 실제로 만나는지'에 초점을 맞춘 한 줄 설명이 붙어 있어, 로그나 API 응답에서 낯선 코드를 봤을 때 원인을 빠르게 좁힐 수 있습니다.

이 레퍼런스는 서버 조회가 필요 없는 순수 정적 데이터라 브라우저 안에서 즉시 검색·필터링됩니다. 코드 숫자, 이름, 설명 어느 쪽으로도 검색할 수 있고 상태 클래스(1xx~5xx)별 탭으로 좁혀 볼 수 있어, 특정 코드를 외우지 않아도 상황에 맞는 코드를 찾아 쓰기 좋습니다.

사용 방법

검색창에 코드 숫자(예: 429)나 이름·키워드(예: timeout, 캐시)를 입력하면 코드·이름·설명 전체에서 실시간으로 걸러집니다.
상단 탭(전체 / 1xx / 2xx / 3xx / 4xx / 5xx)으로 특정 클래스만 추려 볼 수 있으며, 검색어와 함께 사용해 범위를 더 좁힐 수 있습니다.
표에서 코드·이름과 실무 관점의 설명을 확인해, 로그에서 본 코드의 의미를 파악하거나 API에서 반환할 적절한 코드를 고르는 데 활용합니다.

자주 묻는 질문

401과 403은 어떻게 다른가요?: 401 Unauthorized는 사실상 '미인증' 상태로, 인증 정보가 없거나 유효하지 않아 로그인이 필요하다는 뜻입니다(WWW-Authenticate 헤더 동반). 403 Forbidden은 인증은 됐지만 그 리소스에 대한 권한이 없다는 뜻이라, 재인증해도 접근할 수 없습니다.
301과 308, 302와 307의 차이는 무엇인가요?: 301·302는 역사적으로 리다이렉트 시 메서드가 GET으로 바뀌는 동작이 흔합니다. 반면 308(영구)·307(임시)은 원래 메서드와 본문을 반드시 유지합니다. POST 요청을 리다이렉트하면서 메서드를 보존해야 한다면 307/308을 써야 합니다.
429가 보이면 어떻게 대응하나요?: 429 Too Many Requests는 레이트 리밋 초과입니다. 응답의 Retry-After 헤더가 재시도 가능한 시점을 알려 주므로, 클라이언트는 그 값을 존중해 지수 백오프(exponential backoff)로 재시도하도록 구현하는 것이 좋습니다.
502와 504는 무엇이 다른가요?: 둘 다 게이트웨이·프록시(리버스 프록시·로드밸런서)가 업스트림과 통신하다 발생합니다. 502 Bad Gateway는 업스트림에서 잘못된 응답을 받은 경우(백엔드 다운·크래시 신호)이고, 504 Gateway Timeout은 업스트림이 제때 응답하지 않은 경우(백엔드 지연 신호)입니다.