HTTP 상태 코드(HTTP Status Code)

HTTP 상태 코드

 

💡 HTTP 상태 코드란?

• 웹 브라우저에서 웹 서버에 HTTP 요청을 보내면 웹 서버는 요청에 따른 처리를 진행한 후에 브라우저에 HTTP 응답 메시지를 보낸다.
• 서버에서의 처리 결과는 응답 메시지의 상태 라인에 있는 상태 코드(status code)를 보고 파악할 수 있다.
• 상태 코드는 세 자리 숫자로 되어 있는데 첫 번째 숫자는 HTTP 응답의 종류를 구분, 나머지 2개의 숫자는 세부적인 응답 내용 구분을 위한 번호이다.
  • 1XX ~ 5XX까지 5가지로 분류해서 사용하고 있다.
• HTTP 응답에 포함되는 상태 코드는 IANA(Internet Assigned Numbers Authority, 인터넷 할당 번호 관리 기관)이 HTTP 상태 코드 레지스트리라는 이름으로 관리하고 있다.
  • https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml

💡 HTTP 상태 코드의 종류

• 1XX: Informational(정보 제공)
  • 임시 응답으로 현재 클라이언트의 요청까지는 처리되었으니 계속 진행하라는 의미
  • HTTP 1.1 버전부터 추가되었다.
• 2XX: Success(성공)
  • 클라이언트의 요청이 서버에서 성공적으로 처리되었다는 의미
• 3XX: Redirection(리다이렉션)
  • 완전한 처리를 위해 추가 동작이 필요한 경우
  • 주로 서버의 주소 또는 요청한 URI의 웹 문서가 이동되었으니 그 주소로 다시 시도하라는 의미
• 4XX: Client Error(클라이언트 에러)
  • 없는 페이지를 요청하는 등 클라이언트의 요청 메시지 내용이 잘못된 경우를 의미
• 5XX: Server Error(서버 에러)
  • 서버 사정으로 메시지 처리에 문제가 발생한 경우
  • 서버의 부하, DB 처리 과정 오류, 서버에서 익셉션이 발생하는 경우를 의미

 

1XX: Informational(정보 제공)

상태 코드	상태 텍스트	뜻	서버 측면에서의 의미
1XX	Informational	정보 제공	클라이언트의 요청을 받았으며 작업을 계속 진행하고 있다. 1xx 계열의 응답은 HTTP/1.1 클라이언트에게만 보낼 수 있으며 응답은 바디 없이 상태 라인, 헤더(생략 가능), 빈 줄로 종료됩니다.
100	Continue	계속	계속 진행하라. 클라이언트는 요청 헤더에 ‘Expect: 100-continue’를 보내고 서버는 이를 처리할 수 있으면 이 코드로 응답합니다.
101	Switching Protocols	프로토콜 전환	프로토콜을 전환하라. 프로토콜을 HTTP 1.1에서 업그레이드할 때 Upgrade 응답 헤더에 표시합니다. 현재는 HTTP 1.1이 최신이므로 사용할 일이 없습니다.
102	Processing	처리중	(WebDAV) 처리 중이다. 서버가 처리하는 데 오랜 시간이 예상되어 클라이언트에서 타임 아웃이 발생하지 않도록 이 응답 코드를 보냅니다.
103	Early Hints		이 상태 코드는 주로 Link 헤더와 함께 사용되어 서버가 응답을 준비하는 동안 사용자 에이전트가(user agent) 사전 로딩(preloading)을 시작할 수 있도록 한다.
104 ~ 199	Unassigned		현재 할당되지 않은 상태 코드입니다.

 

2XX: Success(성공)

상태 코드	상태 텍스트	뜻	서버 측면에서의 의미
2XX	Success	성공	클라이언트가 요청한 동작을 수신하여 이해하였고 승낙하였으며 성공적으로 처리하였다.
200	OK	성공	서버가 요청을 성공적으로 처리하였다.
201	Created	생성됨	요청이 처리되어서 새로운 리소스가 생성되었다. 응답 헤더 Location에 새로운 리소스의 절대 URI를 기록합니다.
202	Accepted	허용됨	요청은 접수하였지만, 처리가 완료되지 않았다. 응답 헤더의 Location, Retry-After를 참고하여 클라이언트는 다시 요청을 보냅니다.
203	Non-AuthoritativeInformation	신뢰할 수 없는정보	응답 헤더가 오리지널 서버로부터 제공된 것이 아니다. 프록시 서버가 응답 헤더에 주석을 덧붙인 경우가 하나의 예입니다.
204	No Content	콘텐츠 없음	처리를 성공하였지만, 클라이언트에게 돌려줄 콘텐츠가 없다. 응답에는 헤더만 있고 바디는 없습니다. DELETE 요청에 대한 응답에 많이 사용됩니다.
205	Reset Content	콘텐츠 재설정	처리를 성공하였고 브라우저의 화면을 리셋하라. 예를 들어 브라우저가 입력 폼을 보여 주고 있을 때 이 응답 코드를 받으면 브라우저는 모든 입력 항목을 리셋하고 재입력할 수 있는 상태가 됩니다.
206	Partial Content	일부 콘텐츠	콘텐츠의 일부만을 보낸다. 응답 헤더의 Content-Range에 응답 콘텐츠의 범위를 기록합니다. 예를 들어 1,500 바이트의 리소스 중에서 처음의 500바이트만을 보낼 때 사용할 수 있습니다.
207	Multi-Status	다중 상태	(WebDAV) 처리 결과의 스테이터스가 여러 개이다. 207 응답은 성공을 뜻하지만, 각각의 처리 결과가 성공인지는 바디를 봐야 알 수 있습니다.
208	Already Reported		(WebDAV) propstat(property와 status의 합성어) 응답 속성으로 동일 컬렉션으로 바인드된 복수의 내부 멤버를 반복적으로 열거하는 것을 피하기 위해 사용됩니다.
208 ~ 225	Unassigned		현재 할당되지 않은 상태 코드입니다.
226	IM Used		서버가 GET 요청에 대한 리소스의 의무를 다 했고, 그리고 응답이 하나 또는 그 이상의 인스턴스 조작이 현재 인스턴스에 적용이 되었음을 알려줍니다.
227 ~ 299

 

3XX: Redirection(리다이렉션)

상태 코드	상태 텍스트	뜻	서버 측면에서의 의미
3XX	Redirection	리다이렉션	클라이언트는 요청을 마치기 위해 추가 동작을 취해야 한다.
300	Multiple Choices	여러 선택항목	선택 항목이 여러 개 있다. 지정한 URI에 대해서 콘텐츠 협상을 수행한 결과 서버에서 콘텐츠를 결정하지 못하고 클라이언트에게 복수 개의 링크를 응답할 때 사용합니다.
301	Moved Permanently	영구 이동	지정한 리소스가 새로운 URI로 이동하였다. 이동할 곳의 새로운 URI는 응답 헤더 Location에 기록합니다.
302	Found	다른 위치 찾음	요청한 리소스를 다른 URI에서 찾았다. 요청한 URI가 없으므로 클라이언트 메소드를 그대로 유지한 채 응답 헤더 Location에 표시된 다른 URI로 요청을 재송신할 필요가 있습니다. 302의 의미를 정확하게 개선해서 307을 정의하였으므로 이 응답 코드의 사용은 권장하지 않습니다.
303	See Other	다른 위치 보기	다른 위치로 요청하라. 요청에 대한 처리 결과를 응답 헤더 Location에 표시된 URI에서 GET으로 취득할 수 있습니다. 브라우저의 폼 요청을 POST로 처리하고 그 결과 화면으로 리다이렉트시킬 때 자주 사용하는 응답 코드입니다.
304	Not Modified	수정되지 않음	마지막 요청 이후 요청한 페이지는 수정되지 않았다. If-Modified-Since와 같은 조건부 GET 요청일 때 지정한 리소스가 갱신되지 않았음을 알려 줍니다. 이 응답 코드에는 바디가 없습니다.
305	Use Proxy	프록시 사용	지정한 리소스에 액세스하려면 프록시를 통해야 한다. 응답 헤더 Location에 프록시의 URI를 기록합니다.
306	(Unused)		예전 버전에서 사용하다가 현재는 사용하지 않는 상태 코드입니다.
307	Temporary Redirect	임시 리다이렉션	임시로 리다이렉션 요청이 필요하다. 요청한 URI가 없으므로 클라이언트 메소드를 그대로 유지한 채 응답 헤더 Location에 표시된 다른 URI로 요청을 재송신할 필요가 있습니다. 클라이언트는 향후 요청 시 원래 위치를 계속 사용해야 합니다. 302의 의미를 정확하게 재정의해서 HTTP/1.1의 307 응답으로 추가되었습니다.
308	Permanent Redirect		이것은 리소스가 이제 HTTP 응답 헤더의 Location: 에 명시된 영구히 다른 URI에 위치하고 있음을 의미합니다. 이것은 301 Moved Permanently HTTP 응답 코드와 동일한 의미를 가지고 있으며, 사용자 에이전트가 반드시 HTTP 메소드를 변경하지 말아야 하는 점만 다릅니다: 만약 첫 요청에 POST가 사용되었다면, 두번째 요청도 반드시 POST를 사용해야 합니다.
309~399	Unassigned		현재 할당되지 않은 상태 코드입니다.

 

4XX: Client Error(클라이언트 에러)

상태 코드	상태 텍스트	뜻	서버 측면에서의 의미
4XX	Client Error	클라이언트 에러	클라이언트의 요청에 오류가 있다.
400	Bad Request	잘못된 요청	요청의 구문이 잘못되었다. 클라이언트가 모르는 4xx 계열 응답 코드가 반환된 경우에도 클라이언트는 400과 동일하게 처리하도록 규정하고 있습니다.
401	Unauthorized	권한 없음	지정한 리소스에 대한 액세스 권한이 없다. 응답 헤더 WWW-Authenticate에 필요한 인증 방식을 지정합니다.
402	Payment Required	결제 필요	지정한 리소스를 액세스하기 위해서는 결제가 필요하다. 이 응답 코드는 실제로는 사용되지 않습니다.
403	Forbidden	금지됨	지정한 리소스에 대한 액세스가 금지되었다. 401 인증 처리 이외의 사유로 리소스에 대한 액세스가 금지되었음을 의미합니다. 리소스의 존재 자체를 은폐하고 싶은 경우는 404 응답 코드를 사용할 수 있습니다.
404	Not Found	찾을 수 없음	지정한 리소스를 찾을 수 없다.
405	Method Not Allowed	허용되지 않은메소드	요청한 URI가 지정한 메소드를 지원하지 않는다. 응답 헤더 Allow에 이 URI가 지원하는 메소드 목록을 기록합니다.
406	Not Acceptable	수용할 수 없음	클라이언트가 Accept-* 헤더에 지정한 항목에 관해 처리할 수 없다. 응답 바디에는 300 응답처럼 서버가 수용 가능한 다른 선택지 리스트가 기록됩니다.
407	Proxy AuthenticationRequired	프록시 인증 필요	클라이언트는 프록시 서버에 인증이 필요하다. 프록시 서버의 응답 헤더 Proxy-Authenticate에 필요한 인증 방식을 지정합니다.
408	Request Timeout	요청 시간초과	요청을 기다리다 서버에서 타임아웃하였다.
409	Conflict	충돌	서버가 요청을 수행하는 중에 충돌이 발생하였다. 예를 들어 사용자명을 new_name으로 변경하려 하였지만, 서버에 이미 new_name이라는 사용자가 존재하는 경우입니다. 응답 헤더 Location에는 충돌이 발생한 리소스의 URI를 기록합니다.
410	Gone	사라짐	지정한 리소스가 이전에는 존재하였지만, 현재는 존재하지 않는다. 예를 들어 사용자명을 new_name으로 변경하려 하였지만, 서버에 이미 new_name이라는 사용자가 존재하는 경우입니다. 응답 헤더 Location에는 충돌이 발생한 리소스의 URI를 기록합니다.
411	Length Required	길이 필요	요청 헤더에 Content-Length를 지정해야 한다.
412	Precondition Failed	사전 조건 실패	If-Match와 같은 조건부 요청에서 지정한 사전 조건이 서버와 맞지 않는다.
413	Request EntityToo Large	요청 객체가너무 큼	요청 메시지가 너무 크다. 서버는 접속을 끊습니다.
414	Request-URIToo Large	요청 URI가너무 긺	요청 URI가 너무 길다.
415	UnsupportedMedia Type	지원되지 않는미디어 유형	클라이언트가 지정한 미디어 타입을 서버가 지원하지 않는다. 예를 들어 서버가 지원하는 이미지는 JPG, PNG뿐인데 클라이언트가 GIF 형식의 이미지를 요청하는 경우입니다.
416	Range Not Satisfiable	처리할 수 없는요청 범위	클라이언트가 지정한 리소스의 범위가 서버의 리소스 사이즈와 맞지 않는다.
417	Expectation Failed	예상 실패	클라이언트가 지정한 Expect 헤더를 서버가 이해할 수 없다.
418 ~ 421	Unassigned		현재 할당되지 않은 상태 코드입니다.
422	Unprocessable Entity	처리할 수 없는엔티티	(WebDAV) 클라이언트가 송신한 XML이 구문은 맞지만, 의미상 오류가 있다.
423	Locked	잠김	(WebDAV) 지정한 리소스는 잠겨있다.
424	Failed Dependency	의존 관계로 실패	(WebDAV) 다른 작업의 실패로 인해 본 요청도 실패하였다.
426	Upgraded Required	업그레이드필요함	클라이언트의 프로토콜의 업그레이드가 필요하다. 응답에 Upgrade 헤더를 보내 필요한 프로토콜을 알려 줍니다.
428	Precondition Required	사전 조건 필요함	If-Match와 같은 사전조건을 지정하는 헤더가 필요하다. If-Match 헤더가 있지만, 맞지 않는 경우는 412 응답을 보냅니다.
429	Too Many Requests	너무 많은 요청	클라이언트가 주어진 시간 동안 너무 많은 요청을 보냈다. 요청의 속도를 제한할 때 사용합니다. 응답에 Retry-After 헤더를 보내 얼마나 기다릴지를 알려 줄 수 있습니다.
431	Request Header Fields Too Large	너무 큰 헤더	헤더의 길이가 너무 크다. 헤더의 전체 크기가 크거나 또는 하나의 헤더가 매우 큰 경우입니다. 보통 Referer URL이 길거나 쿠키 항목이 많은 경우입니다.
444	Connection Closed Without Response	응답 없이연결 닫음	(NGINX) 응답을 보내지 않고 연결을 종료하였다. 보통 악의적인 요청에 대해서 사용하며 클라이언트에서는 응답을 볼 수 없고 Nginx 로그에는 나타납니다.
451	Unavailable For Legal Reasons	법적 사유로 불가	법적으로 문제가 있는 리소스를 요청하였다.
452 ~ 499	Unassigned		현재 할당되지 않은 상태 코드입니다.

 

5XX: Server Error(서버 에러)

상태 코드	상태 텍스트	뜻	서버 측면에서의 의미
5XX	Server Error	서버 에러	클라이언트의 요청은 유효한데 서버가 처리에 실패하였다.
500	Internal Server Error	내부 서버 오류	서버에 에러가 발생하였다. 클라이언트가 모르는 5xx 계열의 응답 코드가 반환된 경우에도 클라이언트는 500과 동일하게 처리하도록 규정하고 있습니다.
501	Not Implemented	구현되지 않음	요청한 URI의 메소드에 대해 서버가 구현하고 있지 않다.
502	Bad Gateway	불량 게이트웨이	게이트웨이 또는 프록시 역할을 하는 서버가 그 뒷단의 서버로부터 잘못된 응답을 받았다.
503	Service Unavailable	서비스 제공불가	현재 서버에서 서비스를 제공할 수 없다. 보통은 서버의 과부하나 서비스 점검 등 일시적인 상태입니다.
504	Gateway Timeout	게이트웨이 시간초과	게이트웨이 또는 프록시 역할을 하는 서버가 그 뒷단의 서버로부터 응답을 기다리다 타임아웃이 발생하였다.
505	HTTP Version Not Supported	HTTP 버전미지원	클라이언트가 요청에 사용한 HTTP 버전을 서버가 지원하지 않는다.
506	Unassigned		현재 할당되지 않은 상태 코드입니다.
507	Insufficient Storage	용량 부족	(WebDAV) 서버에 저장 공간 부족으로 처리에 실패하였다.
508	Loop Detected	루프 감지	서버가 요청을 처리하는 동안 무한 루프를 감지했습니다.
510	Not Extended (OBSOLETED)	추가 확장 필요	서버가 요청을 이행하려면 요청에 대한 추가 확장이 필요합니다.
511	Network Authentication Required	네트워크 인증 필요	클라이언트가 네트워크 액세스를 얻기 위해 인증을 받아야 할 필요가 있음을 나타냅니다.
509, 512 ~ 599	Unassigned		현재 할당되지 않은 상태 코드입니다.

 

 

 

---

•  출처
  • https://developer.mozilla.org/ko/docs/Web/HTTP/Status
  • https://hongong.hanbit.co.kr/http-상태-코드-표-1xx-5xx-전체-요약-정리/