DevToolPal
PT
5xx Erros do servidor

502 Bad Gateway

Gateway inválido

O que significa

Um gateway ou proxy recebeu uma resposta inválida do servidor upstream para o qual repassou a requisição.

Causas comuns

  • O servidor da aplicação caiu ou não está escutando (porta ou socket errado)
  • O upstream fechou a conexão ou enviou cabeçalhos malformados
  • Reinício de processos PHP-FPM, Gunicorn ou Node

Como resolver

Se você é o cliente ou visitante

Tente de novo daqui a pouco; geralmente é temporário. Se persistir, o backend do site está fora do ar.

Se você mantém o site ou a API

Verifique se o processo upstream está rodando e escutando no endereço que o proxy usa, e leia o log de erros do proxy para ver o erro exato.

Resposta de exemplo

HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0

Especificação

RFC 9110 §15.6.3

Perguntas frequentes

› Como corrijo 502 Bad Gateway no nginx?

Verifique o upstream (o app está rodando, o endereço/socket do proxy_pass está correto) e o log de erros do nginx; reinicie o servidor da aplicação se ele caiu.

› 502 ou 504?

502: o upstream respondeu lixo ou fechou a conexão. 504: o upstream não respondeu a tempo.