~ / hub / erros / Erro 413 Request Entity Too Large
4 out 2026errosguia de solução

Erro 413 Request Entity Too Large

O upload passou do limite. O limite pode estar em várias camadas.

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_filesize e post_max_size no php.ini (o segundo deve ser maior ou igual ao primeiro).
  • Node/Express: express.json({ limit: '10mb' }) e, para arquivos, o limite do multer/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.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →