Erro 502 Bad Gateway: o que é e como resolver

O erro 502 Bad Gateway é um código de status HTTP que informa ao usuário que o servidor que está atuando como gateway ou proxy recebeu uma resposta, ou solicitação inválida de um servidor upstream. Resumindo, este erro normalmente ocorre devido a uma dificuldade do servidor HTTP se comunicar com outro servidor intermediário.

Para entendermos melhor, vejamos como este processo funciona em um ambiente de rede complexa. Quando um site ou aplicativo possui um grande tráfego, muitas vezes se faz necessária a utilização de mais de um servidor. 

Sendo assim, existem os servidores intermediários que atuam como gateway ou proxy. O objetivo é otimizar o desempenho e evitar quedas de servidor, aumentar a segurança, entre outros benefícios para administrador e usuário. 

Apesar deste erro de protocolo HTTP não ser tão comum quanto outros, ele ainda pode trazer transtornos. Tanto usuário quanto administrador devem procurar alternativas para solucionar este erro. Sendo assim, vejamos o que é, como funciona e quais as soluções! 

O que é o erro 502 Bad Gateway? 

Quando um usuário acessa um site que utiliza servidores de balanceamento de carga ou servidores proxy reversos, a solicitação inicial é enviada para outro servidor que realizará o processamento. Portanto, temos o intermédio entre servidores com o objetivo de otimizar a experiência do usuário com maior velocidade de processamento. 

O exemplo mais comum de servidor que faz este tipo de serviço é o NGINX. 

O intermediário e o upstream: quem é quem

O erro 502 envolve dois servidores, e entender o papel de cada um é o que torna o diagnóstico possível.

O servidor intermediário — proxy reverso ou balanceador — é quem recebe a requisição do visitante. Ele não gera conteúdo: sua função é encaminhar o pedido, verificar o cache, distribuir a carga e devolver a resposta. Nginx e Cloudflare são os exemplos mais comuns.

O servidor upstream é quem realmente processa e gera a resposta. Em um site WordPress, normalmente é o PHP-FPM; em uma aplicação Node, é o processo da aplicação; e pode ser também um conjunto de servidores atrás de um balanceador.

⚠️ A confusão mais comum é achar que upstream significa “servidor mais acima”. É o contrário: upstream é o destino final, quem tem o conteúdo. O intermediário fica entre você e ele.

O 502 acontece exatamente nessa passagem. O intermediário conseguiu falar com o upstream, mas a resposta que voltou não fez sentido — veio truncada, vazia, ou não veio.

⚠️ E é isso que distingue o 502 do 504. No 502, o upstream respondeu algo inválido. No 504, ele não respondeu a tempo — silêncio em vez de resposta ruim. São causas diferentes e soluções diferentes.

Quando ocorre o erro 502?

Basicamente, o erro 502 Bad Gateway acontece quando o servidor que atua como intermediário não obtém uma resposta válida do servidor principal, também conhecido como servidor upstream. Isso pode ocorrer por diversos motivos. Os principais são: 

• O servidor principal pode estar temporariamente indisponível (fora do ar, manutenção, etc)
• O servidor upstream respondeu de forma inválida — resposta truncada, vazia ou malformada
• Problemas de configurações em ambos os servidores (intermediário e upstream). 
• Problemas no equipamento de rede que se torna instável ou interrompido entre os servidores.

Portanto, quando o erro 502 Bad Gateway ocorre, o usuário se depara com uma mensagem de erro genérica que informa ao usuário que ocorreu um problema ao acessar o site. 

Observe que também há uma mensagem indicando os dizeres “cloudflare-nginx”. O termo “Cloudflare-nginx” é uma referência ao servidor proxy reverso Nginx usado pelo Cloudflare. Este último é um serviço de rede de entrega de conteúdo, também conhecido pelas siglas CDN, e também faz parte dos requisitos de segurança na web. 

O CloudFlare atua como intermediário, fornecendo maior desempenho para distribuição de conteúdo e maior proteção contra ataques, garantindo uma experiência segura ao usuário. 

Quando esta indicação aparece junto à mensagem do erro 502 Bad Gateway, significa que o tráfego do site passa diretamente por servidores do Cloudflare, que está sendo processado pelo Nginx, parte indispensável na estrutura do Cloudflare.

Conforme o navegador e a infraestrutura do website, você também pode se deparar com a seguinte variante da mensagem de erro: 

Logs de erro do NGINX mostrando o erro 502

Os logs podem parecer discretos, porém irão exibir: HTTP/1.1 502.

189.25.72.208 - - [28/Jun/2023:17:47:58 -0300] "GET / HTTP/1.1" 502 559 "-" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
189.25.72.208 - - [28/Jun/2023:17:48:01 -0300] "GET /favicon.ico HTTP/1.1" 502 559 "http://seusite.com.br/" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"

Um print do terminal, com os erros 502 bad gateway marcados em amarelo:

Quais as soluções para o erro 502 Bad Gateway? 

Com este resumo do erro 502 Bad Gateway, é possível perceber que a solução está mais relacionada à parte do administrador do que cliente/usuário. No entanto, algumas configurações incorretas, como conexão, por exemplo, podem estar afetando o lado do usuário. Sendo assim, vejamos as diferentes soluções para ambos. 

Vamos dividir esta explicação em duas etapas: explicaremos as soluções para um cliente (um usuário comum navegando na internet), e soluções para um administrador de servidores.

Recarregar a página

Muitas vezes, um dos servidores (intermediário ou upstream) pode estar tendo uma leve instabilidade por diferentes motivos, o que leva o usuário a receber a mensagem. Como em muitos casos, aguardar alguns minutos e tentar um novo acesso pode solucionar o problema rapidamente. Pressione F5 para reiniciar a página e aguarde. Porém, se o erro persistir, devemos buscar outras alternativas. 

Ainda neste mesmo caminho, você pode tentar utilizar um navegador diferente. Se está utilizando o Google Chrome, por exemplo, tente acessar o mesmo site utilizando o Microsoft Edge ou Mozilla. Isto se dá pelo fato do navegador estabelecer uma nova conexão, e uma nova tentativa é muito válida. 

Alternativa em outros dispositivos 

Se o erro persistir após estas primeiras tentativas, busque, se possível, tentar o acesso através de um dispositivo diferente. Acesse a página utilizando um outro computador ou smartphone, por exemplo. Outra tentativa válida é conectar-se a uma nova rede e realizar um novo teste. 

Limpar cache DNS e navegador

Manter sua máquina e sua rede sempre limpas evita arquivos corrompidos ou mal resolvidos que podem estar afetando sua navegação. Sendo assim, limpar o cache do navegador e realizar o flush do seu DNS são outras resoluções bastante acessíveis. Vejamos como realizar nos diferentes sistemas operacionais: 

Windows: 

• Digite “cmd” no campo na barra de pesquisa do Windows e, em seguida, abra o prompt de comando. Ao abrir o prompt de comando, digite: ipconfig /flushdns
• Em seguida, pressione a tecla “Enter”

Ubuntu

• Abra o terminal e digite o seguinte comando: sudo systemd-resolve –flushcaches
• Em seguida, pressione a tecla “Enter”

Para outras distribuições Linux

• Abra o terminal e digite o seguinte comando: sudo /etc/init.d/dns-clean start
• Em seguida, pressione a tecla “Enter”.

Reiniciar conexão

Verifique a estabilidade da sua conexão. Reiniciar seu modem restabelecerá sua conexão e corrigirá possíveis erros que estejam afetando o equipamento de rede em geral. Após o procedimento, tente recarregar a página.

Caso nenhuma das alternativas apresentadas acima funcione, isto significa que o erro não está relacionado à sua máquina ou equipamento de rede. Logo, partimos para as questões ligadas à resolução por parte do administrador. 

Soluções para administradores dos servidores

Naturalmente, os administradores possuem pleno acesso e informações sobre novas atualizações e configurações dos seus servidores. Se o erro 502 Bad Gateway passou a acontecer após uma destas aplicações, é possível buscar registros de erro dentro do próprio servidor. 

É importante estar atento às possíveis mudanças de desempenho que as configurações irão aplicar. Sendo assim, conforme o tipo de hospedagem e servidor utilizado, a busca por logs de erro pode ser uma alternativa que fornecerá informações concretas sobre o erro e, a partir disso, buscará soluções imediatas. 

A causa mais comum: PHP-FPM

Em servidores Nginx, o PHP não é executado diretamente — o Nginx repassa a requisição ao PHP-FPM, que processa e devolve. Se o PHP-FPM cai, trava ou esgota o pool de processos, o Nginx não recebe resposta válida e devolve 502.

É a causa nº 1 em sites WordPress com Nginx. Verifique com:

sudo systemctl status php8.2-fpm

Ajuste a versão conforme o seu servidor. Se o serviço estiver parado, reinicie:

sudo systemctl restart php8.2-fpm

⚠️ E se ele cair de novo em minutos, o problema não é o serviço — é o que o esgota. Procure no log do PHP-FPM por server reached pm.max_children, que indica pool insuficiente para o tráfego.

Em hospedagem compartilhada, você não faz isso. O PHP-FPM é gerenciado pelo provedor, e reiniciá-lo exige acesso que você não tem. Nesse caso, o caminho é abrir um chamado informando o horário exato em que o erro apareceu — é o que permite ao suporte localizar a ocorrência no log.

Verificar o servidor upstream

Se o PHP-FPM está ativo e o erro persiste, o problema pode estar em outro serviço upstream — ou na comunicação com ele.

Para solucionar o erro, verifique se este servidor está fora do ar ou se existe algum bloqueio no firewall que impeça a comunicação.

Por exemplo, no NGINX, este servidor upstream é definido pela diretiva proxy_pass. Nesta diretiva, indicam-se o endereço IP e a porta do servidor.

Contato com o suporte técnico

Se a causa do erro não for aparente mesmo após diversas tentativas, você pode entrar em contato com o suporte técnico responsável pela hospedagem do seu website. Certifique-se de ter todas as informações já coletadas para acelerar o processo de atendimento. Verifique previamente os logs, equipamento de rede, conexões e dispositivos diferentes e métricas. Quanto mais informações tiver, mais fácil será buscar a causa raiz e realizar o “troubleshooting”. 

Plugins e extensões

Uma causa comum são os problemas com plugins armazenados em cache. Portanto, recomendamos também desabilitar plugins e realizar um rápido teste; é o primeiro passo.

Se seu site está hospedado no WordPress, por exemplo, você pode navegar até o diretório wp-content e buscar o diretório de plugins. Vale ressaltar que cada serviço de hospedagem possui diferentes caminhos para chegar até o diretório. Caso não consiga de imediato, o suporte técnico pode orientá-lo neste passo. 

Veja também

O erro 502 faz parte da classe 5XX dos códigos de status HTTP (erros do servidor). Confira também: 500 Erro Interno do Servidor , 504 Gateway Timeout e 503 Serviço Indisponível.

O mesmo indicador aparece em outros erros 5xx atrás da CDN — veja erro 500 no Cloudflare para saber quando o erro é da origem e quando é do próprio Cloudflare. Erros no Nginx que não são 5xx: veja 403 Forbidden no Nginx.

Perguntas Frequentes

O que significa o erro 502 Bad Gateway?

Significa que um servidor intermediário (gateway ou proxy) recebeu uma resposta inválida do servidor de origem. É um erro do lado do servidor: a comunicação entre os dois falhou, e o intermediário não teve o que entregar ao visitante.

O erro 502 é problema meu ou do site?

Quase sempre é do site. O 502 é gerado na comunicação entre servidores, não no seu computador. Ainda assim, vale recarregar a página, limpar o cache do navegador e do DNS e testar em outra rede — em uma minoria dos casos, cache local corrompido ou problema de conexão contribuem.

Qual a diferença entre 502, 503 e 504?

No 502, o servidor de origem respondeu, mas com algo inválido. No 503, ele está temporariamente indisponível, por sobrecarga ou manutenção. No 504, ele simplesmente demorou demais e o intermediário desistiu de esperar. Os três são erros 5xx, do lado do servidor.

O que significa “cloudflare-nginx” na mensagem de erro?

É uma referência ao Nginx que o Cloudflare usa como proxy reverso. Quando esse termo aparece, o tráfego do seu site está passando pelo Cloudflare — o que também indica que o erro pode ter sido gerado por lá, e não pela sua origem.

Por que o PHP-FPM causa erro 502?

Porque em servidores Nginx o PHP não é executado diretamente: o Nginx repassa a requisição ao PHP-FPM. Se o serviço estiver caído, reiniciando ou com o pool esgotado, o Nginx não recebe resposta válida e devolve 502. É a causa mais comum em sites WordPress com Nginx, e a verificação é direta: systemctl status php8.2-fpm (ajuste para a sua versão).

Como resolver o erro 502 no WordPress?

Comece desativando os plugins — renomeie a pasta wp-content/plugins via FTP ou gerenciador de arquivos. Se resolver, reative um a um para achar o culpado. Depois verifique o tema, limpe o cache do site e do CDN, e confira os logs de erro do servidor, que apontam a causa exata.

Quanto tempo dura o erro 502?

Quando é instabilidade momentânea do servidor de origem, costuma durar de segundos a poucos minutos. Se persistir por mais tempo, há um problema real na configuração ou no serviço upstream — e aí só a intervenção do administrador ou do suporte resolve.

O erro 502 prejudica o SEO?

Um erro pontual, não. Mas um 502 persistente impede que os buscadores acessem suas páginas, e mecanismos de busca reduzem a frequência de rastreamento de sites que retornam erros de servidor com frequência. Resolvido rapidamente, o impacto é insignificante.

Conclusão

O erro 502 tem uma boa notícia embutida: ele diz onde procurar. O intermediário funcionou, chegou a falar com o upstream, e a resposta é que veio errada — então o problema está no que gera o conteúdo, não na rede nem no navegador.

Três coisas resolvem a maioria dos casos. Em WordPress com Nginx, a causa nº 1 é o PHP-FPM parado ou com o pool esgotado. Depois vêm os plugins, que se testam desativando todos e reativando um a um. E, se o site usa Cloudflare, vale confirmar se o erro é da origem ou da própria CDN.

E a distinção que evita perder tempo: no 502, o upstream respondeu algo inválido; no 504, ele não respondeu a tempo. Um pede olhar o serviço e os logs; o outro, carga e desempenho.

Um 502 isolado acontece com qualquer site. Um 502 recorrente é sintoma de infraestrutura — e aí a resposta não está em recarregar a página, mas no log do servidor.