의미
서버가 Content-Length 헤더를 요구하는데 요청에 없습니다.
흔한 원인
- 청크 인코딩을 받지 않는 서버에 청크 업로드
- 길이 없이 본문을 스트리밍하는 클라이언트 라이브러리
- 본문도 Content-Length: 0도 없는 POST
해결 방법
클라이언트 또는 방문자라면
Content-Length를 보내거나(빈 POST에는 Content-Length: 0), 본문을 버퍼링해 클라이언트가 계산할 수 있게 하세요.
사이트나 API 운영자라면
가능하면 청크 전송 인코딩을 받아들이거나, 길이가 필요하다고 문서화하세요.
응답 예시
HTTP/1.1
HTTP/1.1 411 Length Required
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Length Required",
"status": 411,
"detail": "Send a Content-Length header with the upload."
}명세
자주 묻는 질문
› 빈 POST가 411을 반환하는 이유는?
본문이 없어도 Content-Length를 요구하는 서버가 있습니다. Content-Length: 0을 보내세요.
› HTTP/2에도 Content-Length가 필요한가요?
아니요. HTTP/2와 HTTP/3는 본문을 스스로 프레이밍하므로 411은 주로 HTTP/1.1 문제입니다.