O que significa
O usuário (ou o rastreador) fala com um gateway; o gateway fala com a origem. Um 502 significa que esse segundo salto falhou: a origem travou, expirou, fechou a conexão ou devolveu algo malformado. O próprio gateway geralmente está bem.
Causas comuns
- Processos da origem travando ou encerrando no meio de uma requisição (bugs de deploy, erros fatais de PHP/Python).
- Timeouts da origem sob carga — o gateway desiste antes de a aplicação terminar.
- Esgotamento de recursos: pools de conexões com o banco de dados, workers, memória.
- Configuração incompatível após um deploy: porta, protocolo ou nome do upstream errados.
Por que isso importa para o SEO
Rastreadores de buscadores que recebem 502s tratam as URLs como temporariamente indisponíveis e tentam de novo depois — 502s sustentados levam à desindexação exatamente como os 500s. Como os 502s costumam aparecer em rajadas (picos de tráfego, deploys), monitorar os códigos de resposta ao longo do tempo importa mais do que qualquer rastreamento isolado.
Compare a frequência de 502 com os horários dos deploys e com as curvas de tráfego nos seus logs — a correlação costuma apontar o culpado.
FAQ
O 502 é um problema do lado do cliente?
Não. Nada que o navegador ou o rastreador faça consegue corrigi-lo. A falha está entre o gateway e o servidor de origem.
Como diferenciar 502 de 503 e 504?
502: a origem devolveu uma resposta inválida. 503: o servidor se declara indisponível (geralmente com Retry-After). 504: a origem não respondeu a tempo.