🌐 4XX (Client Error) 상태 코드

409 Conflict

• 서버가 요청을 수행하는 중에 충돌이 발생하였다.

• Conflict ⇢ 클라이언트의 요청이 서버의 상태와 충돌이 발생

• 요청 처리 중 비지니스 로직상 불가능하거나 모순이 생긴 경우 사용된다.

• 여타 4XX 상태 코드 처럼 요청에 있어 메소드 지원 유무나, 자원 유무, 인증 유무와 같은 확실한 오류 상황들을 제외한 로직 오류 상황에서 쓰인다.

• 사실 충돌(conflict)이라는 것은 추상적인 오류 현상이기 때문에, 여타 4XX 상태 코드에 속하지 않은 애매한 오류의 상황들을 처리하는데 이용된다고 보면 된다.

• 그래서 응답은 충돌에 대해 설명하는 구체적인 본문을 포함해야 한다.

410 Gone

• 지정한 리소스가 이전에는 존재하였지만, 현재는 존재하지 않는다.

• Gone ⇢ 리소스가 영구히 삭제됨

• 404 Not Found와 비슷하나 410 응답은 요청한 컨텐츠가 서버에서 영구히 삭제되어 전달해 줄 주소가 존재하지 않을때 사용된다.

411 Length Required

• 요청 헤더에 Content-Length를 지정해야 한다.

• Length Required ⇢ 요청 메시지에 Content-Length 헤더가 있을 것을 요구

• 서버에서 로직을 처리하는데 필요로 하는 Content-Length 헤더 필드가 없어 서버가 요청을 거절할때 응답된다.

• 클라이언트가 서버에 chunk 데이터를 보낼때, 인코딩을 받아들여주지 않을 경우에도 이용된다.

• 클라이언트는 요청 헤더에 Content-Length 를 포함하고 재요청하면 된다.

412 Precondition Failed

• If-Match와 같은 조건부 요청에서 지정한 사전 조건이 서버와 맞지 않는다.

• Precondition Failed ⇢ 클라이언트의 조건부 요청 실패

• 클라이언트가 캐시에 대한 조건부 요청 Visit Website을 했는데 실패했을 때 응답된다. (Etag나 수정일짜 불일치)

• 304 Not Modified 처럼 캐시 관련 요청에서 쓰이는 코드이다.

• 단, POST PUT DELETE 메소드 등 GET HEAD 이외의 메소드에서만 요청했을때만 사용된다.

• 이 상태 코드를 따르면 '업데이트 손실' 문제를 피할 수 있다. 업데이트 손실은 여러 사람이 동일한 리소스를 쓰고 있고 한 명 이상이 오래된 버전으로 작업할 때, 리소스가 수정되지 않았는지 확인함으로써 중간에 수정된 데이터를 덮어쓰거나 수정하지 않도록 보장한다.

304 와 412 상태 코드 차이

• 단순히 앞자리 숫자가 다르다를 물어보는 것이 아니다.

• 304 Not Modified 와 412 Precondition failed 는 웹브라우저의 캐시 관련 헤더와 연관된 상태 코드로서, 클라이언트의 리소스 수정 상태와 서버의 리소스 수정 상태가 다르면 응답하게 된다.

• 그럼 무슨 기준으로 어떤건 정상 코드이고 어떤건 오류 코드 인지 혼동이 올수 있는데 의외로 간단하다.

• 304 응답은 GET 과 HEAD 메소드에만 동작한다.

• 412 응답은 이를 제외한 POST PUT PATCH 등 메소드에만 동작한다.

• 따라서 위의 쇼핑몰 예제에서 412 응답이 반환된 이유는 PATCH 메소드를 통해 엑세스 하려고 하였기 때문이다.

413 Payload Too Large

• 요청 메시지가 너무 크다.

• Payload Too Large ⇢ 요청 본문이 서버에서 정의한 한계보다 너무 커 처리할수 없음

• 413 Request Entity Too Large 로도 쓰여짐

• 서버가 처리할 수 있는 한계를 넘은 크기의 본문을 포함한 요청을 클라이언트가 보냈을 때 사용한다.

• 서버는 연결을 끊거나 혹은 Retry-After 헤더 필드로 돌려보낼 것이다.

414 URI Too Long

• 요청 URL이 너무 길다.

• URI Too Long ⇢ 요청 URI이 너무 길어 처리할수 없음

• 413 Request URI Too Long 로도 쓰여짐

• 서버가 처리할 수 있는 한계를 넘은 길이의 요청 URI를 클라이언트가 보냈을때 응답된다.

415 Unsupported Media Type

• 클라이언트가 지정한 미디어 타입을 서버가 지원하지 않는다.

• Unsupported Media Type ⇢ 요청한 미디어 포맷은 서버에서 지원하지 않음

• 서버가 이해하거나 지원하지 못하는 내용 유형의 본문을 클라이언트가 보낼때 응답된다.

416 Range Not Satisfiable

• 클라이언트가 지정한 리소스의 범위가 서버의 리소스 사이즈와 맞지 않는다.

• Range Not Satisfiable ⇢ Range 헤더 필드에 요청한 지정 범위를 만족시킬 수 없음

• 클라이언트가 리소스의 특정 범위를 요청했는데, 그 범위가 잘못되었거나 맞지 않을 때 응답된다.

417 Expectation Failed

• 클라이언트가 지정한 Expect 헤더를 서버가 이해할 수 없다.

• Expectation Failed ⇢ Expect 요청 헤더 필드로 요청한 예상 반환 코드를 만족 시킬 수 없음

• Expect 요청 헤더와 연관있는 상태 코드 (성공하면 100, 실패하면 417)

418 I’m a teapot

• I’m a teapot ⇢ 만우절 농담 상태 코드

• 이 오류는 1998년 만우절 농담이었던 하이퍼 텍스트 커피 포트 제어 규약(Hyper Text Coffee Pot Control Protocol)의 레퍼런스다.

420 Method Failure or Enhance your calm

• 클라이언트 오류를 나타내기 위해 서버에서 반환하는 비공식 클라이언트 오류

• Spring Framework에서 메서드가 실패했음을 나타내는 비공식 응답코드로도 쓰였음 (지금은 안쓰임)

421 Misdirected Request

• Misdirected Request ⇢ 잘못된 방향의 요청

• 의도하지 않은 요청을 받아 서버가 응답을 생성할 수 없음을 나타냄

422 Unprocessable Entity

• (WebDAV) 클라이언트가 송신한 XML이 구문은 맞지만, 의미상 오류가 있다.

• Unprocessable Entity ⇢ 서버에서 본문을 처리할수 없음

• 이 응답은 서버가 요청을 이해하고 요청 문법도 올바르지만 요청된 지시를 따를 수 없음을 나타냄

• 요청 데이터에 대해 validation 처리를 하면서 적합하지 않은 데이터를 받았을 때 반환

423 Locked

• (WebDAV) 지정한 리소스는 잠겨있다.

• Locked ⇢ 리소스는 접근하는 것이 잠겨있음

• 요청에 대한 대상 파일 또는 폴더가 잠겨 있을때 반환

• WebDAV에 사용되는 응답 코드

424 Failed Dependency

• (WebDAV) 다른 작업의 실패로 인해 본 요청도 실패하였다.

• 요청된 작업이 실패한 다른 작업에 의존하기 때문에 수행할 수 없음

• 즉, 이전 요청이 실패하였기 때문에 지금의 요청도 실패하였음을 의미

• WebDAV에 사용되는 응답 코드

426 Upgrade Required

• 클라이언트의 프로토콜의 업그레이드가 필요하다.

• Upgrade Required ⇢ 프로토콜 업그레이드 권고

• 서버가 현재 프로토콜을 사용하여 요청을 수행 의사가 없음을 나타내기 위해 반환되는 응답 코드이다.

• 예를들어 서버는 HTTP/1.1 버전은 받지않고 HTTP/2 이상만 받는다고 할때, 클라이언트가 HTTP/1.1로 요청을 보내는 상황을 말할 수 있다.

• 서버는 응답할때Upgrade 헤더에 필요로 하는 프로토콜을 클라이언트에게 알려준다.

• 프로토콜 관련 101 Switching Protocols 상태 코드와 관련이 있다.

428 Precondition Required

• If-Match와 같은 사전조건을 지정하는 헤더가 필요하다.

• Precondition Required ⇢ 조건부 요청이 요구됨

• 서버가 클라이언트에게 요청을 조건부로 해야 함을 나타낸다.

• 일반적으로 If-Match와 같은 필수 전제 조건부 헤더가 누락됬을때 반환된다.

• 만일 조건부 헤더가 서버 측 리소스 상태와 일치하지 않을 경우 응답은 412 Precondition Failed가 되게 된다.

429 Too Many Requests

• 클라이언트가 주어진 시간 동안 너무 많은 요청을 보냈다.

• Too Many Requests ⇢ 클라이언트가 일정 시간 동안 너무 많은 요청을 보낸 경우

• 서비스가 클라이언트의 요청량을 제한하려는 경우 이용된다. (예를 들어 API 사용건수를 시간당 100개 로 제한)

• 혹은 디도스와 같은 비정상적인 방법으로 자원을 마구마구 요청하는 경우, 서버는 가용성을 위해 요청 임시 제한을 걸 수 있다.

• Retry-After 헤더를 이용하여 몇초 뒤에 재시도 할 것을 나타낸다.

431 Request Header Fields Too Large

• 헤더의 길이가 너무 크다.

• Request Header Fields Too Large ⇢ 헤더 필드가 너무 커서 요청을 처리하지 않음

• 총 요청 헤더 필드 수가 너무 많은 경우 또는 단일 헤더 필드가 너무 큰 경우 응답된다.

• 클라이언트는 요청 헤더 필드의 크기를 줄인 후 재요청 하면 된다.

451 Unavailable For Legal Reasons

• 법적으로 문제가 있는 리소스를 요청하였다.

• Unavailable For Legal Reasons ⇢ 법적인 이유로 비허용됨

• 클라이언트가 법적 이유로 사용할 수 없는 불법적인 리소스를 요청했음을 나타낸다. (정부에 의해 검열된 웹페이지 등)