Tutoriais de VPS
Nginx 400 Header or Cookie Too Large: encontre o campo e ajuste o limite
Identifique cookies e cabeçalhos grandes, diferencie falhas do corpo e da resposta upstream, configure o Nginx de forma persistente e teste todo o fluxo de login.

Depois do login, um site que funcionava passa a exibir 400 Bad Request e Request Header Or Cookie Too Large. Um campo Cookie ou outro cabeçalho da requisição pode ter ultrapassado o limite do servidor que o recebe. O visitante pode comparar uma janela anônima; quem administra o site precisa identificar o campo grande e a camada que o rejeita.
Para recuperar o acesso temporariamente, apague os cookies desse site e entre novamente. Se o erro voltar, investigue servidor e aplicação. Aumentar client_max_body_size altera o limite do corpo, como uploads, e normalmente não resolve cabeçalhos grandes.
Abra a mesma URL completa, primeiro sem login e depois autenticado. Se funciona na janela anônima, mas não na habitual, remova somente os cookies desse domínio nas configurações do navegador. Isso pode exigir novo login e apagar carrinho ou preferências armazenados em cookies.
Não é necessário limpar todos os sites. Se o erro começa imediatamente após o login, informe ao responsável a URL, o horário e a diferença entre acesso autenticado e anônimo. Limpar cookies reduz a próxima requisição, mas não muda o limite nem impede que a aplicação gere dados grandes novamente.
| Erro ou log | O que conferir primeiro | Correção correspondente |
|---|---|---|
| 400 com Header Or Cookie Too Large | Cookie, Authorization e outros cabeçalhos enviados ao Nginx | Buffers de requisição e tamanho dos cookies ou tokens |
| 431 Request Header Fields Too Large | Proxy ou aplicação que respondeu | Limite de um campo ou do conjunto de cabeçalhos |
| 414 URI Too Long | Caminho e query string | Tamanho da URL e da linha de requisição |
| 413 Request Entity Too Large | Upload ou corpo enviado | Limite do corpo na entrada e na aplicação |
| 502 com upstream sent too big header | Resposta do backend, como Set-Cookie | Resposta da aplicação e buffers de resposta |
400 sozinho não comprova Cookie grande. Requisições malformadas também retornam esse código. Confira mensagem e logs. O 431 pode indicar um campo ou o conjunto inteiro, conforme a referência da MDN. Para upload com 413, veja os limites de Nginx, PHP e Cloudflare.
Selecione a requisição com erro em Network, nas ferramentas do navegador. Confira URL, status e Request Headers, especialmente Cookie, Authorization e campos personalizados longos. Compare a mesma página antes e depois do login, não apenas a página inicial.
Vários cookies pequenos podem compor um único campo Cookie grande. Cookies com o mesmo nome e Domain ou Path diferentes podem aparecer juntos. document.cookie não mostra cookies HttpOnly; examine a requisição efetiva.
No VPS, identifique versão, configuração ativa e caminhos dos logs:
nginx -v
sudo nginx -T
sudo tail -n 100 /var/log/nginx/error.log
Adapte os caminhos. nginx -T expande a configuração e mostra seus arquivos de origem, ajudando a encontrar http, server e definições duplicadas. Registre nomes e comprimentos dos campos; remova cookies, tokens e credenciais antes de compartilhar saídas.
Pode aparecer client sent too large header, mas o nível configurado talvez não registre essa mensagem. A ausência não descarta a causa. Se o access log inclui $upstream_status, compare o horário com os logs do backend para saber se a aplicação recebeu a requisição. O nome Nginx na página de erro não identifica qual proxy respondeu.
Os padrões documentados pelo Nginx são:
client_header_buffer_size 1k;
large_client_header_buffers 4 8k;
1k é o buffer inicial. Quando necessário, buffers maiores podem ser alocados; isso não significa um limite absoluto de 1 KB. 4 8k permite até quatro buffers grandes de 8 KB cada.
No HTTP/1.1, cada campo precisa caber em um buffer grande. Um Cookie com mais de 8 KB não recebe um espaço contínuo de 64 KB ao selecionar 8 8k. A documentação da diretiva distingue linha de requisição longa, com 414, de campo longo, com 400.
O artigo original relata um teste local isolado com Nginx 1.19.6 e HTTP/1.1. Cinco cookies simulados, cada um com 1.800 caracteres ASCII, produziram um valor Cookie de 9.023 bytes. O endpoint normalmente retornava 204:
| Configuração | Sem cookies | Cookie simulado de 9.023 bytes |
|---|---|---|
4 8k | 204 | 400, aviso de Cookie grande |
8 8k | 204 | 400 novamente |
4 16k | 204 | 204; cabeçalho aceito |
Esse teste histórico explica os parâmetros do HTTP/1.1. Use uma versão mantida em produção. O 204 só mostra que a requisição simulada foi aceita, não que o login real funcionou. Confira HTTP/2 e HTTP/3 na versão e no protocolo que você utiliza.
Se requisições legítimas precisam de mais espaço, passar cada buffer grande de 8 KB para 16 KB pode ser um ponto de partida. Continue investigando os dados produzidos pela aplicação. Escolha o limite final conforme tamanho dos campos, tráfego e demais proxies.
Este trecho deve entrar no bloco http existente. Edite as definições atuais; não adicione outro bloco http:
client_header_buffer_size 1k;
large_client_header_buffers 4 16k;
As diretivas aceitam http e server, mas não location. Em http, sites sem sobrescrita herdam os valores; avalie outros domínios na mesma máquina. Em um server específico, confira servidor padrão, SNI, Host e fase de processamento, conforme a seleção de servidores virtuais.
Faça backup do arquivo real antes de editar. Aqui usamos /etc/nginx/nginx.conf; substitua pela configuração do site quando necessário e use um nome novo para a cópia:
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/nginx.conf.header-backup-20261109
Depois de salvar, confira a configuração:
sudo nginx -t
Somente com a verificação bem-sucedida, recarregue:
sudo systemctl reload nginx
Para reverter, restaure o backup, teste e recarregue. Buffers grandes são alocados conforme a demanda, mas muitas requisições grandes simultâneas aumentam o uso de memória. Não copie valores enormes como 16 128k sem uma necessidade comprovada.
No Docker, edite a configuração persistente do host montada no contêiner. Se o serviço Compose se chama nginx, teste antes de recarregar:
docker compose exec nginx nginx -t
docker compose exec nginx nginx -s reload
Adapte o serviço. Alterar um arquivo temporário dentro do contêiner pode perder a mudança na recriação. Em BaoTa, 1Panel ou Nginx Proxy Manager, use a entrada persistente do painel e confirme que o contexto aceita essas diretivas.
Um buffer maior não justifica cookies crescendo continuamente. Causas comuns: perfil completo, lista de permissões ou carrinho no Cookie; tokens com muitos papéis; e plugins antigos deixando cookies de mesmo nome em caminhos diferentes.
Remova campos desnecessários ou use um identificador de sessão menor com dados no servidor, se a aplicação permitir. Ao remover cookies antigos, corresponda ao Domain e Path originais. Teste saída, renovação e autorização após alterar o gerenciamento de sessões.
Na cadeia navegador → CDN → Nginx → aplicação, todas as camadas podem limitar cabeçalhos. Aumentar o limite da origem não corrige uma rejeição da CDN. O Nginx pode aceitar enquanto o backend retorna 431. Siga a mesma requisição por todas as camadas.
Se o log mostra upstream sent too big header, o problema ocorre ao ler a resposta do upstream, talvez com Set-Cookie grande. Confira essa resposta e proxy_buffer_size, em vez de aumentar buffers do cliente. Veja proxy_buffer_size.
Reteste a janela original e mantenha a requisição com erro como referência. Em uma janela limpa, entre, atualize uma página autenticada, saia e entre novamente. Confira estabilidade dos tamanhos, desaparecimento da falha e requisições corretas no backend. Um curl sem cookies na página inicial não reproduz o problema.
Evite http2_max_field_size e http2_max_header_size de tutoriais antigos de HTTP/2. Ambas estão obsoletas desde 1.19.7; a alternativa documentada é large_client_header_buffers. Consulte o módulo HTTP/2 e reteste o protocolo efetivo.
Para problemas relacionados: