4UptimePage EntrarCriar conta grátis

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.

Por Equipe UptimePage · · 3 min de leitura
Arco entre dois blocos de servidor com um cabo partido soltando faíscas verdes

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:

  1. Veja o log de erro do proxy (no Nginx, error.log): mensagens como "connect() failed" ou "upstream prematurely closed".
  2. Confira se o processo da aplicação está rodando.
  3. 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:

  1. Verifique se alguém ativou manutenção.
  2. Olhe as verificações de saúde do balanceador.
  3. 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:

  1. Identifique quais rotas dão timeout.
  2. Veja o log de consultas lentas do banco.
  3. Coloque tempo limite nas chamadas externas da aplicação.
  4. Mova processamentos longos para filas em segundo plano.

Resumo rápido

CódigoEm uma frasePrimeiro lugar para olhar
502A aplicação respondeu errado ou não respondeuA aplicação está rodando?
503O serviço não está disponível agoraManutenção, limite de workers, balanceador
504A aplicação demorou demaisBanco, 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.

#erro 502#erro 503#erro 504#http#nginx#proxy

Saiba que caiu antes do seu cliente.

Monitore sites, APIs e servidores a cada 30 segundos, receba o alerta onde estiver e mostre uma status page aos seus clientes. 5 monitores grátis, sem cartão.

Começar grátis