Length Required

개요

411 Length Required는 서버가 요청 본문의 크기를 미리 알아야 하는데 Content-Length 헤더가 없어서 처리를 거부한다는 뜻입니다. 서버가 chunked transfer encoding을 지원하지 않거나, 정책상 본문 길이를 명시하도록 요구할 때 발생합니다.

대부분의 HTTP 클라이언트 라이브러리는 본문을 보낼 때 Content-Length를 자동으로 붙이므로, 이 오류는 주로 저수준 소켓 코드나 스트리밍 업로드에서 나타납니다.

언제 발생하나

• 본문이 있는 POST/PUT 요청을 Content-Length 없이 보냈을 때
• 스트리밍(chunked) 업로드를 서버가 허용하지 않을 때
• 직접 만든 HTTP 클라이언트가 길이 헤더를 누락했을 때

요청 / 응답 예시

POST /upload HTTP/1.1
Host: api.example.com
Content-Type: application/octet-stream

<binary body with no Content-Length>

HTTP/1.1 411 Length Required
Content-Type: text/plain
Content-Length: 33

Content-Length header is required.

코드로 보기

# Let curl compute and send Content-Length from a file
curl -X POST --data-binary @payload.bin \
  -H 'Content-Type: application/octet-stream' \
  https://api.example.com/upload

# Reject chunked requests where a length is mandatory
if ($http_content_length = "") {
  return 411;
}

실무 참고

• Content-Length는 실제 본문 바이트 수와 정확히 일치해야 합니다. 값이 틀리면 요청이 잘리거나 400으로 거부될 수 있습니다.
• 본문이 지나치게 큰 경우에는 411이 아니라 413 Content Too Large가 반환됩니다.

관련 상태코드

관련 헤더

스펙 근거