1. Significado
O 413 (Request Entity Too Large / Payload Too Large) indica que o corpo da requisição — normalmente um upload — é maior que o limite aceito por alguma camada do caminho. O difícil é descobrir qual camada barrou.
2. Nginx
server {
client_max_body_size 50m; # padrão: 1m
}
Pode ser definido em http, server ou location. Depois de editar, teste e recarregue:
sudo nginx -t && sudo systemctl reload nginx
3. Outras camadas que também limitam
- PHP:
upload_max_filesizeepost_max_sizeno php.ini (o segundo deve ser maior ou igual ao primeiro). - Node/Express:
express.json({ limit: '10mb' })e, para arquivos, o limite domulter/busboy. - Apache:
LimitRequestBody. - Ingress do Kubernetes (nginx-ingress): anotação
nginx.ingress.kubernetes.io/proxy-body-size. - CDN, WAF ou balanceador de nuvem: costumam ter limites próprios, que não mudam no seu servidor.
4. Descubra qual camada respondeu
curl -i -F "[email protected]" https://seusite.com/upload
Observe o cabeçalho Server: e o corpo da resposta. Uma página HTML do Nginx indica o proxy; um JSON da sua aplicação indica o limite do código. Confira também o error.log do Nginx (“client intended to send too large body”).
5. Boas práticas
- Defina um limite explícito e coerente em todas as camadas, com folga pequena.
- Para arquivos muito grandes, use upload direto para armazenamento de objetos (URL pré-assinada) ou upload em partes.
- Valide tipo e tamanho também no servidor; limite no cliente é só conveniência.
SEGURANÇA Não libere limites enormes “de uma vez”: uploads grandes consomem disco, memória e banda e podem ser abusados. Combine com rate limiting.
Continue explorando
← erros · Nginx proxy reverso · 500 · 504 · Termo: Nginx
Veja também o hub de conteúdo, o glossário e os cursos gratuitos.