Erro 502, 503 e 504: o que cada um significa e como resolver
Entenda a diferença entre os erros HTTP 502 Bad Gateway, 503 Service Unavailable e 504 Gateway Timeout, as causas mais comuns e como diagnosticar cada um.

Os erros 502, 503 e 504 são os mais comuns quando um site cai. Eles aparecem com nomes parecidos e, para o visitante, dão no mesmo: a página não abre. Mas cada um aponta para um problema diferente, e saber ler o código economiza muito tempo de investigação.
O papel do proxy
Quase todo site moderno tem uma camada na frente da aplicação: Nginx, Apache, um balanceador de carga, o Cloudflare ou um API gateway. Esse intermediário recebe o pedido do visitante e repassa para a aplicação (PHP-FPM, Node, Java, um container).
Os erros 502, 503 e 504 normalmente são respostas desse intermediário dizendo que algo deu errado na conversa com a aplicação.
502 Bad Gateway
O que significa: o proxy conseguiu falar com o servidor de trás, mas recebeu uma resposta inválida, ou a conexão foi recusada.
Causas comuns:
- A aplicação caiu ou está reiniciando (PHP-FPM, Node, container parado).
- O socket ou a porta configurada no proxy está errada.
- A aplicação travou por falta de memória e foi encerrada pelo sistema.
- Firewall bloqueando a comunicação entre proxy e aplicação.
Como investigar:
- Veja o log de erro do proxy (no Nginx,
error.log): mensagens como "connect() failed" ou "upstream prematurely closed". - Confira se o processo da aplicação está rodando.
- Procure por encerramentos por falta de memória no log do sistema.
503 Service Unavailable
O que significa: o servidor está acessível, mas não consegue atender agora. Muitas vezes é proposital.
Causas comuns:
- Modo de manutenção ativado.
- Todos os servidores do balanceador marcados como fora de serviço.
- Limite de conexões ou de processos atingido (por exemplo, todos os workers ocupados).
- Proteção contra excesso de requisições ou ataque.
Como investigar:
- Verifique se alguém ativou manutenção.
- Olhe as verificações de saúde do balanceador.
- Veja se o pico de tráfego esgotou os workers. Em PHP-FPM, por exemplo, mensagens de "max_children reached".
Se for uma parada planejada, registre uma janela de manutenção para não contar como queda nem gerar alerta.
504 Gateway Timeout
O que significa: o proxy esperou a resposta da aplicação e o tempo acabou.
Causas comuns:
- Consulta lenta no banco de dados.
- Chamada a um serviço externo que não responde (gateway de pagamento, API de terceiros).
- Processamento pesado dentro da requisição, como gerar relatórios grandes.
- Tempo limite do proxy menor do que o tempo real da operação.
Como investigar:
- Identifique quais rotas dão timeout.
- Veja o log de consultas lentas do banco.
- Coloque tempo limite nas chamadas externas da aplicação.
- Mova processamentos longos para filas em segundo plano.
Resumo rápido
| Código | Em uma frase | Primeiro lugar para olhar |
|---|---|---|
| 502 | A aplicação respondeu errado ou não respondeu | A aplicação está rodando? |
| 503 | O serviço não está disponível agora | Manutenção, limite de workers, balanceador |
| 504 | A aplicação demorou demais | Banco, serviços externos, tempos limite |
E os erros do Cloudflare?
Com o Cloudflare na frente, você pode ver variações como 520, 521, 522, 523 e 524. Em geral elas indicam problemas entre o Cloudflare e o seu servidor: servidor recusando conexão, inacessível ou demorando demais. Os princípios de investigação são os mesmos.
Detecte antes do cliente
Esses erros costumam ser intermitentes: aparecem por alguns minutos e somem. Um monitoramento a cada 30 segundos ou 1 minuto registra o código HTTP e o horário de cada falha, o que ajuda a cruzar com os logs. No UptimePage, cada queda guarda o código, os cabeçalhos e o início da resposta, e o alerta chega com essa informação. Veja também como monitorar uma API.
Perguntas frequentes
O erro 502 é culpa do servidor ou do visitante?
Do servidor. Erros 5xx indicam falha do lado de quem serve o site. Erros 4xx (como 404) indicam problema na requisição.
Recarregar a página resolve?
Às vezes, quando o problema é passageiro. Se o erro persiste, é preciso investigar a aplicação ou a infraestrutura.
Erro 503 afeta o SEO?
Paradas curtas com 503 são entendidas pelo Google como temporárias. Quedas longas ou frequentes podem prejudicar o rastreamento e o posicionamento.


