O que significa
O servidor exige um cabeçalho Content-Length e a requisição não o incluiu.
Causas comuns
- Upload em chunks para um servidor que não aceita codificação chunked
- Uma biblioteca cliente transmitindo o corpo sem tamanho
- POST sem corpo e sem Content-Length: 0
Como resolver
Se você é o cliente ou visitante
Envie Content-Length (Content-Length: 0 para POST vazio) ou armazene o corpo em buffer para que o cliente possa calculá-lo.
Se você mantém o site ou a API
Aceite codificação de transferência chunked quando possível, ou documente que o tamanho é obrigatório.
Resposta de exemplo
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."
}Especificação
Perguntas frequentes
› Por que um POST vazio retorna 411?
Alguns servidores exigem Content-Length mesmo sem corpo; envie Content-Length: 0.
› O HTTP/2 precisa de Content-Length?
Não. HTTP/2 e HTTP/3 enquadram o corpo por conta própria, então o 411 é principalmente um problema do HTTP/1.1.