502 Gateway inválido

O que é um erro 502 Bad Gateway, suas causas comuns em upstream e proxies, como o Googlebot o trata e o impacto no rastreamento e na indexação.

Publicado pela primeira vez: 28 de jun. de 2026 · Última atualização: 9 de ago. de 2026 · Avançado
Idiomas
1 sinal de evidência nesta página

Um 502 Bad Gateway significa que um proxy ou gateway à frente do site (uma CDN, um balanceador de carga ou um proxy reverso) recebeu uma resposta inválida do servidor de origem atrás dele. É um problema de infraestrutura, não do Search Console. A documentação do Google agrupa 502 com 500 e 503 sob o mesmo tratamento de 5xx: o rastreamento desacelera proporcionalmente à quantidade de URLs com erro, o conteúdo de respostas 5xx é ignorado e as páginas são removidas do índice se os erros persistirem. O Google não publica uma duração segura específica nem garante recuperação automática, então um pico breve traz muito menos risco prático do que um erro que continua voltando — mas não é oficialmente isento de risco. Diagnostique por camada (CDN, proxy reverso, origem) e correlacione marca, cabeçalhos, IDs de rastreamento e logs em vez de confiar apenas na página de erro.

TL;DR — Um 502 é uma falha na camada de proxy/gateway: a RFC 9110 §15.6.3 o define como um gateway ou proxy recebendo uma resposta inválida de um servidor de entrada. Ele é diferente de um 500 (a aplicação na origem apresentou erro) e de um 503 (a origem está deliberadamente indisponível). A documentação do Google agrupa 500, 502 e 503 sob o mesmo tratamento de 5xx — a taxa de rastreamento cai proporcionalmente à quantidade de URLs com erro, o conteúdo 5xx é ignorado e erros persistentes removem páginas do índice. A recuperação é gradual quando o 2xx volta, embora o Google não publique um cronograma fixo. A duração importa, mas não existe um limiar oficial: picos breves trazem muito menos risco prático, enquanto erros que continuam se repetindo colocam as páginas em risco — as observações de Mueller de novembro de 2025 os situam informalmente em torno de vários dias, não como um SLA documentado. Diagnostique por camada — CDN, proxy reverso ou origem — e correlacione as evidências entre os saltos em vez de confiar apenas em uma página de erro com marca.

O que um 502 realmente sinaliza

A RFC 9110 §15.6.3 define especificamente o 502 como um gateway ou proxy recebendo uma resposta inválida de um servidor de entrada que acessou ao tentar atender à solicitação. Esse limite da especificação é importante — ele identifica onde o gateway observou a falha, não necessariamente qual salto a causou. O status 502 é evidência de uma falha no limite entre camadas, não prova de que a aplicação na origem está quebrada. É justamente essa distinção que a maioria dos artigos concorrentes de “13 maneiras de corrigir” deixa indistinta, e por isso o diagnóstico abaixo é por camadas, não uma lista plana. Evidence for this claim A 502 response means a gateway or proxy received an invalid response from an upstream server. Scope: RFC 9110 defines the gateway response semantics; it does not identify which infrastructure layer caused a specific failure. Confidence: high · Verified: IETF: RFC 9110 §15.6.3 — 502 Bad Gateway

Compare os códigos 5xx que podem ser confundidos:

  • 500 Internal Server Error — a própria aplicação na origem apresentou erro (bug no código, exceção não tratada, esgotamento de recursos). A origem respondeu, e a resposta foi “eu quebrei”.
  • 502 Bad Gateway — o proxy recebeu uma resposta malformada ou inválida do upstream (RFC 9110 §15.6.3).
  • 503 Service Unavailable — a origem está deliberadamente indisponível; este é o código intencional, sancionado pelo Google, de “volte mais tarde”, usado para manutenção planejada, idealmente com um cabeçalho Retry-After.
  • 504 Gateway Timeout — o proxy esperou pelo upstream e não recebeu nada antes de o timeout expirar (RFC 9110 §15.6.5). (502 = resposta inválida; 504 = nenhuma resposta a tempo.)
Evidence for this claim A 502 response means a gateway or proxy received an invalid response from an upstream server. Scope: RFC 9110 defines the gateway response semantics; it does not identify which infrastructure layer caused a specific failure. Confidence: high · Verified: IETF: RFC 9110 §15.6.3 — 502 Bad Gateway

A consequência prática: 503 é o código que você escolhe de propósito; 502 é o código que acontece com você quando a infraestrutura falha.

Como o Googlebot trata um 502

Esta é a parte que vale fundamentar na documentação real do Google, em vez do “isso pode prejudicar os rankings” vago que você encontrará em outros lugares. O documento do Google sobre erros HTTP e de rede lista 502 (bad gateway) como um código 5xx e dá a todos os códigos 5xx o mesmo tratamento:

  • A taxa de rastreamento cai proporcionalmente. O Google reduz a taxa de rastreamento do site, e a redução é proporcional à quantidade de URLs individuais que retornam um erro de servidor. Alguns 502 são algo pequeno; um 502 no site inteiro é um “diminua o ritmo” inequívoco.
  • O conteúdo 5xx é ignorado. Tudo o que o Google recebe de uma URL que retorna 5xx é ignorado — ele não indexará uma página de erro 502 como seu conteúdo.
  • A preservação no índice é temporária. URLs já indexadas permanecem no índice no início, mas o pipeline de indexação do Google remove URLs que retornam um erro de servidor persistentemente.
  • A recuperação é automática e gradual. Quando o servidor volta a responder com 2xx, o Google aumenta gradualmente a taxa de rastreamento. Não é necessário reenviar, pedir reconsideração ou fazer heroísmos com “validar correção” para a recuperação normal — esse botão apenas pede ao Google que verifique novamente mais cedo.

A conclusão mais importante: 502 recebe o mesmo tratamento que 500 e 503. Ele não é “menos grave” por ter origem na camada de proxy/CDN em vez da aplicação na origem. Não existe tolerância documentada para 502. Evidence for this claim Google handles 502 with its general 5xx behavior: reduced crawling, ignored response content, and eventual removal of persistently failing URLs. Scope: Google explicitly lists 502 among 5xx server errors; it does not guarantee that a particular short outage has no ranking effect. Confidence: high · Verified: Google: How HTTP status codes affect Google's crawlers

A duração é toda a história

O fato de um 502 realmente prejudicar você depende de quanto tempo ele dura — mas o Google não publica uma duração segura fixa nem um limiar fixo para remoção, então trate o que segue como contexto prático, não como um SLA:

  • Um pico breve (minutos a algumas horas) → a redução da taxa de rastreamento do Google acompanha a quantidade de URLs com erro, então um pico curto e de pequena escala tem impacto prático limitado e geralmente não vale ser perseguido no Search Console. Nada na documentação do Google isenta formalmente erros curtos — é uma questão de grau, não um corte rígido.
  • Um erro que continua se repetindo ou permanece ativo → esta é a janela em que se aplica a formulação do Google “retornam um erro de servidor persistentemente”, e as páginas podem começar a sair do índice. O Google não define “persistentemente” como um número específico de dias. O comentário público de Mueller (abaixo) o situou informalmente em torno de vários dias, com recuperação relativamente rápida quando o site está saudável — mas essa é a leitura de um profissional sobre um incidente específico, não uma regra documentada na qual você possa confiar para todo site ou CDN.

Isso se relaciona de forma aproximada à interrupção da Cloudflare em novembro de 2025, quando uma onda de sites lançou erros 5xx sem culpa própria. A resposta pública de Mueller no Bluesky foi que o rastreamento com 5xx desacelera, mas “volta a aumentar” — veja a aba Citações para a formulação exata e as ressalvas de origem, incluindo um comentário separado sobre “vários dias” retransmitido por um resumo de terceiros, sem verificação no tópico original. Uma interrupção breve confirmada pelo provedor é quase o melhor caso: é visível, normalmente se resolve sozinha e, quando o provedor confirma a recuperação e suas próprias respostas 2xx voltam, a reação razoável costuma ser evitar mudanças de infraestrutura reativas.

Diagnosticando um 502 por camada

Como um 502 é uma falha de comunicação entre servidores, a maneira mais rápida de encontrá-la é descer pela pilha — CDN, depois proxy reverso, depois origem — em vez de percorrer uma lista plana. (A aba Árvores de decisão apresenta isso passo a passo.)

Um cuidado antes de começar: uma página de erro com marca, o nome de um provedor em um cabeçalho ou a “aparência” de uma interrupção são sinais de evidência, não prova de qual salto falhou. Correlacione isso com cabeçalhos de resposta, IDs de solicitação/rastreamento e logs com registro de horário nos dois lados do salto antes de concluir “é a CDN” ou “é minha origem”.

Camada da CDN/borda

  • Timeout do upstream: o nó de borda não conseguiu obter uma resposta da origem a tempo.
  • A borda não consegue alcançar a origem — falha de resolução DNS, falha no handshake SSL/TLS ou firewall/segurança da origem bloqueando os intervalos de IP da CDN.
  • As causas documentadas variam por provedor: a documentação de solução de problemas da Cloudflare descreve cenários de conectividade com a origem e timeout específicos de sua rede de borda, enquanto a AWS CloudFront documenta seu próprio conjunto de causas relacionadas a TLS, DNS, porta e funções na origem — consulte a documentação da sua CDN específica em vez de presumir que a lista de um provedor se aplica a outro.
  • A própria interrupção do provedor de CDN (Cloudflare, Fastly, AWS etc.) — um evento de 502 em massa entre sites não relacionados, sem relação com a saúde do seu servidor; confirme isso na página de status do provedor, não apenas pela marca na página de erro.

Camada do proxy reverso/balanceador de carga (Nginx, Apache mod_proxy, HAProxy)

  • Timeout do backend ou conexão recusada.
  • Um bloco proxy_pass/upstream mal configurado apontando para o lugar errado.
  • Esgotamento do pool do backend — todos os workers upstream estão ocupados.
  • Incompatibilidade de SSL/TLS entre o proxy e o backend.

Camada do servidor de origem

  • Falha ou reinicialização da aplicação/PHP-FPM, ou encerramento por OOM (limite de memória excedido).
  • Esgotamento das conexões do banco de dados.
  • Um deploy/reinicialização causando uma indisponibilidade breve.
  • Um WAF ou plugin de segurança bloqueando IPs legítimos do proxy ou do rastreador como se fossem invasores — este é o caso sorrateiro, porque navegadores normais funcionam enquanto o proxy (ou o Googlebot) recebe 502s.

Vale destacar esse último padrão: se apenas o Googlebot ou apenas as solicitações via CDN recebem 502 enquanto navegadores normais não, você está diante de um bloqueio específico para bots ou de uma resposta variável, não de uma verdadeira interrupção. Teste diretamente na origem e via CDN, e verifique o que o Googlebot realmente vê com o teste ao vivo de inspeção de URL do Search Console, em vez de presumir um impacto contínuo com base em um relatório de Erro de servidor (5xx) que talvez já esteja desatualizado.

Corrigindo e prevenindo 502s

As correções são específicas da camada, e quem deve executá-las varia conforme o papel:

  • Visitante — nada para corrigir. Recarregue uma vez, tente outra rede se suspeitar de um problema local e, caso contrário, espere; mudanças no navegador não podem reparar uma falha entre servidores.
  • Proprietário do site sem acesso à infraestrutura — confirme o escopo e verifique primeiro as páginas de status/logs (consulte a lista abaixo), depois encaminhe o caso ao host, ao suporte da CDN ou à equipe de desenvolvimento em vez de adivinhar uma correção.
  • Proprietário do host/CDN/aplicação — corrija a configuração do proxy/upstream, aumente timeouts e a capacidade do backend quando a origem for o gargalo real e distribua os deploys para que reinicializações não interrompam todo o pool. Trate allowlisting de WAF, alterações de firewall e edições de configuração de proxy/upstream como mudanças que precisam de aprovação — aplique-as somente depois que logs e evidências do provedor mostrarem de fato uma falha de firewall ou controle de acesso, não como um palpite de primeira resposta; colocar uma CDN ou rastreador em allowlist não é uma correção genérica para 502.

Para prevenção, o básico funciona: monitoramento de disponibilidade com alertas, monitoramento dos logs de erro do servidor e do proxy, acompanhamento do Host status e da tendência de Erro de servidor (5xx) nas estatísticas de rastreamento do Search Console e correlação dos picos com as páginas de status dos seus provedores de CDN e DNS, para distinguir “meu problema” da “interrupção deles” em segundos.

Os códigos relacionados que vale manter em ordem ficam logo ao lado neste grupo: a origem 500, o 503 intencional e o 504 de timeout.

Try it live

This is a real endpoint on this site — not a simulation. Hit it from the button, open it in a new tab, or curl -i it from your terminal, and the server answers with the actual status code this article is about.

Open in new tab ↗

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.