O erro 414 Request-URI Too Large aparece quando o seu navegador envia uma URL que excede o limite máximo de comprimento de URI do seu servidor. Em sites WordPress isso acontece com mais frequência quando um plugin passa valores de filtro de produto, IDs ou parâmetros de consulta como variáveis GET até que a URL cresça além do que o Apache ou o Nginx aceitam.
Resumo: O erro 414 significa que o seu navegador enviou uma URL que excede o limite de comprimento do seu servidor. No Apache, aumente
LimitRequestLine; no Nginx, elevelarge_client_header_buffers. Se você gerencia um plugin do WordPress que gera URLs longas, mude o envio de dados dele para POST.
O que causa o erro 414?
Um erro 414 ocorre quando o URI — o caminho da URL mais a string de consulta — de uma requisição HTTP excede o máximo configurado do servidor. Gatilhos comuns em sites WordPress:
- Strings de consulta longas: Plugins de filtro do WooCommerce ou busca facetada que codificam cada valor de filtro ativo na URL.
- Plugins com uso intenso de GET: Plugins que passam grandes cargas úteis (IDs de produto, dados de usuário) como parâmetros GET em vez de POST.
- Limite de servidor baixo: Um valor
LimitRequestLine(Apache) oularge_client_header_buffers(Nginx) definido abaixo do comprimento de URL do seu site. - Envios de formulário grandes: Formulários que codificam dados na URL em vez de no corpo da requisição.
De qual solução eu preciso?
| Sintoma | Causa provável | Solução recomendada |
|---|---|---|
| O erro aparece apenas em páginas com muitos filtros ativos | O plugin está passando parâmetros GET demais | Mudar as requisições GET para POST |
| O erro aparece mesmo depois de encurtar a URL | O limite de URI do servidor é baixo demais | Elevar o limite do Apache ou do Nginx |
| O erro aparece em todas as páginas, independentemente do conteúdo | O limite do servidor é globalmente baixo demais | Elevar o limite do Apache ou do Nginx |
| Em hospedagem compartilhada sem acesso SSH | Sem acesso direto à configuração | Contatar o suporte da hospedagem com a diretiva |
Solução: Elevar os limites do servidor Apache ou Nginx
Se o erro 414 afeta várias páginas ou persiste depois de encurtar a URL, o limite de comprimento de URI do seu servidor precisa ser aumentado. A mudança é uma única diretiva no arquivo de configuração do seu servidor.
Localize o arquivo de configuração do seu servidor
Abra o seu site WordPress em um navegador, clique com o botão direito na página inicial e selecione Inspecionar.
Nas ferramentas de desenvolvedor, vá até a aba Rede. Clique na primeira requisição (a URL da sua página inicial) para expandir os cabeçalhos dela.
Observe nos Cabeçalhos de resposta a linha Server: — ela exibirá Apache, nginx ou o nome de uma CDN.
As localizações padrão dos arquivos de configuração são:
- Apache 2.4:
/etc/apache2/apache2.conf - Nginx 1.24+:
/etc/nginx/nginx.conf
Para servidores Nginx
Navegue até /etc/nginx/nginx.conf no seu gerenciador de arquivos ou via SSH.
Encontre a diretiva large_client_header_buffers dentro do bloco http { }. A diretiva recebe dois valores: o número de buffers e o tamanho individual deles. Um valor entre 8k e 128k deve cobrir a maioria das configurações do WordPress — use múltiplos de 4k:
Depois de salvar, teste e recarregue o Nginx:
Consulte a documentação de large_client_header_buffers do Nginx para a sintaxe completa do parâmetro.
Para servidores Apache
Abra /etc/apache2/apache2.conf.
Procure pela diretiva LimitRequestLine. Se ela não estiver presente, adicione-a ao final do arquivo. Em nossos testes, o valor padrão de LimitRequestLine do Apache, de 8.190 bytes, é suficiente para a maioria dos sites; normalmente você só atinge o limite quando plugins de filtro do WooCommerce empilham mais de ~50 valores de filtro ativos na URL. Você pode elevá-lo a 256.000 ou mais para eliminar o erro 414 — garanta que o valor seja múltiplo de 2:
Teste a sua configuração e reinicie o Apache:
Consulte a documentação de LimitRequestLine do Apache para a faixa completa de valores permitidos.
Solução: Mudar as requisições GET para POST
Pelos tickets de suporte da WP STAGING, o gatilho mais comum em hospedagem compartilhada é um plugin que passa IDs de produto ou parâmetros de filtro em uma URL GET — mudar para POST resolve de imediato.
Se o erro 414 aparece apenas em páginas específicas de um plugin — filtros de categoria do WooCommerce, resultados de busca facetada ou endpoints da REST API —, o plugin está codificando parâmetros demais na string de consulta. As requisições POST enviam a carga útil no corpo da requisição, contornando por completo o limite de comprimento de URI.
Verifique nas configurações do plugin uma opção rotulada como «filtros baseados em URL», «filtros GET» ou «modo de string de consulta». Se existir um modo POST ou AJAX, ative-o. Se não houver tal configuração, abra um ticket de suporte com o autor do plugin e inclua a URL específica que dispara o 414.
Para os desenvolvedores que criam integrações personalizadas contra a REST API do WordPress, use wp_remote_post() para cargas úteis grandes em vez de wp_remote_get(). A REST API aceita requisições POST para todas as operações de escrita e para endpoints personalizados que expõem um método POST.
Solução: Usar um encurtador de URL como passo de diagnóstico
Encurtar a URL confirma se o 414 é causado apenas pelo comprimento da URL. Quando um usuário acessa a URL encurtada, o encurtador o redireciona para a URL longa original sem que o navegador chegue a enviar o URI completo ao seu servidor. Se a URL encurtada carregar corretamente, o problema fica confirmado como comprimento de URI. Uma vez confirmado, aplique uma solução permanente das anteriores em vez de depender de uma URL encurtada em produção.
Antes de fazer qualquer alteração na configuração do servidor, recomendamos fazer um backup completo do site via WP Staging. CLIQUE AQUI PARA INSTALAR
Observação: URLs encurtadas ocultam o destino, podem expirar se o serviço do encurtador mudar e não oferecem valor de SEO. Use o encurtamento de URL apenas para diagnóstico — não como a correção em produção.
O que fazer se a solução não funcionar
Percorra esta lista de verificação se o erro 414 persistir depois de aplicar uma mudança na configuração do servidor.
Arquivo de configuração alterado, mas o valor não fez efeito?
- Apache: execute
apachectl -t -D DUMP_VHOSTSpara confirmar qual arquivo de configuração está ativo para o seu host virtual. A diretiva global doapache2.confpode ser sobrescrita por umaLimitRequestLineem um bloco<VirtualHost>dentro de/etc/apache2/sites-enabled/. - Nginx: execute
nginx -T | grep large_client_headerpara ver a configuração mesclada efetiva. Um valor em um blocoserver { }sobrescreve o bloco globalhttp { }.
Em hospedagem compartilhada sem acesso SSH?
Contate a equipe de suporte da sua hospedagem e forneça a diretiva exata. Para Apache, solicite LimitRequestLine 256000; para Nginx, large_client_header_buffers 4 16k. A maioria das hospedagens WordPress gerenciadas pode aplicar a mudança à sua conta sem impacto em todo o servidor.
Usa Cloudflare ou outra CDN?
CDNs e proxies reversos impõem os próprios limites de comprimento de URI de forma independente do seu servidor de origem. Se a CDN retorna o 414 antes de a requisição chegar ao Apache ou ao Nginx, mudar a configuração do seu servidor não ajudará. Nesse caso, mudar o plugin de GET para POST é a única opção viável — consulte a documentação da CDN para o comprimento máximo de URL dela.
Conclusão
O erro 414 Request-URI Too Large é causado por uma URL que excede o limite configurado do seu servidor. Na maioria dos sites WordPress, a solução é aumentar o limite em apache2.conf ou nginx.conf, ou mudar o método de requisição de um plugin de GET para POST. Use a tabela de decisão acima para identificar a solução certa para a sua configuração e, em seguida, siga os passos para o seu tipo de servidor.
Artigos relacionados
