Um erro 502 ou 504 interrompe a navegação, mas não aponta sozinho qual componente falhou. O 502 (Bad Gateway) indica que um servidor atuando como gateway ou proxy recebeu uma resposta inválida do servidor a montante. O 504 (Gateway Timeout) indica que esse servidor não recebeu a resposta a tempo. Em ambos os casos, a origem pode estar na aplicação, no banco de dados, no proxy ou na própria capacidade da infraestrutura.
Este roteiro ajuda a investigar a falha antes de reiniciar serviços às cegas ou trocar de hospedagem. Faça uma alteração por vez e registre horário, URL afetada e evidências.
1. Confirme o alcance e o momento do erro
Teste a página inicial e uma rota simples, depois compare com páginas dinâmicas. Verifique a partir de outra rede e observe se o problema é contínuo ou intermitente. Registre o horário com fuso, código HTTP, frequência e se coincide com deploy, pico de acesso ou tarefa agendada. Um teste isolado não prova indisponibilidade geral.
2. Separe conexão, proxy e aplicação
Se houver balanceador, proxy reverso ou CDN, confirme se ele alcança o servidor de origem e se a origem está respondendo. Compare os registros do proxy e do servidor no mesmo intervalo: mensagens como conexão recusada, upstream indisponível ou timeout ajudam a localizar a fronteira da falha. Não desative controles de segurança para “testar” sem uma janela e uma hipótese claras.
3. Procure a causa nos logs da aplicação e do servidor
Verifique os logs de erro do servidor web e da aplicação, além dos registros do PHP ou runtime usado e do banco de dados. Procure aumento de duração, processos encerrados, falha de conexão, limite de recursos atingido e erros que começaram junto com o incidente. Compare com a última alteração de código, plugin, configuração ou consulta.
4. Investigue lentidão que vira timeout
Um 504 pode ser consequência de uma operação lenta, não necessariamente de um servidor indisponível. Identifique endpoints ou consultas demoradas e confira se houve fila de tarefas ou saturação de CPU, memória, disco ou conexões. O guia do web.dev recomenda observar TTFB e dados de usuários reais: como referência geral, sugere buscar TTFB de até 0,8 segundo, mas esse indicador não substitui o diagnóstico e varia conforme a aplicação e a medição. Veja como medir e otimizar TTFB.
5. Faça uma correção reversível e valide
Se a falha começou após uma mudança, avalie rollback controlado. Se for preciso ajustar timeout ou capacidade, confirme primeiro o componente responsável: aumentar timeout pode apenas prolongar a espera e esconder uma consulta travada. Depois da correção, teste rotas afetadas, monitore logs e métricas e confirme se o erro deixou de ocorrer sob condições semelhantes.
Checklist rápido de diagnóstico
- O erro afeta todas as rotas ou apenas uma função?
- Os logs do proxy, servidor, aplicação e banco mostram eventos no mesmo horário?
- Há sinais de saturação ou aumento de latência?
- O início coincide com deploy, atualização ou pico de tráfego?
- A correção foi testada e existe um caminho de reversão?
Quando acionar o provedor de hospedagem
Compartilhe URL e horário com fuso, código HTTP, frequência, testes realizados e trechos relevantes dos logs, removendo senhas, tokens, cookies e dados pessoais. Peça que verifiquem a camada sob responsabilidade do provedor e informe o que você já isolou. Isso torna o suporte mais objetivo sem presumir que todo 502/504 seja problema de hospedagem.
Se os incidentes se repetem, uma avaliação conjunta da aplicação e do ambiente pode ajudar a definir próximos passos. A HAD Cloud pode ser consultada sobre soluções de hospedagem e infraestrutura; disponibilidade, configuração e adequação devem ser confirmadas para cada necessidade.
Perguntas frequentes
502 e 504 significam que o site caiu?
Indicam uma falha de comunicação entre componentes, mas não identificam por si só sua causa nem provam que todo o site está fora do ar.
Devo aumentar o timeout para resolver?
Não como primeiro passo. Sem identificar a operação lenta, isso pode mascarar o gargalo e manter conexões ocupadas por mais tempo.
Esses erros afetam o SEO?
Erros persistentes podem impedir usuários e mecanismos de busca de acessar páginas. Investigue a duração e o alcance do incidente; não há garantia de posição baseada em um único indicador. O Google explica que Core Web Vitals medem experiência real e são considerados por seus sistemas, sem garantir posições: documentação do Google Search Central.
