Erro 500, 502, 503 e 504: o que significa cada um e como resolver

Erro 500 significa que o servidor do site sofreu uma falha interna: recebeu o pedido do visitante, tentou processar e algo quebrou do lado de lá. Os irmãos dele contam variações da mesma história: o 502 é um intermediário que não recebeu resposta válida do servidor, o 503 é um serviço lotado ou em manutenção, e o 504 é uma espera que estourou o tempo limite. Todos são da família 5xx, os erros do lado do servidor: se você é o visitante, a culpa não é sua; se você é o dono do site, a solução está na sua mão.

Resumo rápido: erro 500, 502, 503 e 504

Agora, o porquê de cada linha.

Seu site é um restaurante (e o erro 500 é o prato caindo na cozinha)

Pensa numa sexta-feira à noite num restaurante cheio. Você faz o pedido, o garçom anota, leva para a cozinha e some.

Seu site funciona igualzinho. O visitante é o cliente na mesa, o navegador faz o pedido e, no meio do caminho, quase sempre tem um garçom (o proxy ou CDN, tipo nginx ou Cloudflare) levando cada pedido até a cozinha, que é o seu servidor. Se o cliente pede um prato que não existe no cardápio, o erro é dele: essa é a família 4xx, onde mora o famoso 404. Se o pedido está certo e mesmo assim não sai, o problema é da casa. Essa é a família 5xx.

Erro 500: o que é e como resolver

O erro 500 (Internal Server Error) é a cozinha devolvendo a comanda com um bilhete escrito "não deu". O servidor sabe que algo quebrou, mas não diz o quê, e por isso ele é o mais genérico de todos.

As causas mais comuns, na ordem em que vale suspeitar:

• A última coisa que você mudou. Um deploy, um plugin ou tema atualizado, uma dependência nova. Se o erro apareceu hoje, pense no que você mexeu ontem.
• Um plugin brigando com outro. No WordPress, é o campeão disparado.
• Um .htaccess com uma linha errada. Um caractere fora do lugar derruba o site inteiro.
• Memória do PHP estourada. Comum em hospedagem compartilhada: o site cresceu e o limite ficou pequeno.
• Banco de dados fora do ar. O código está certo, mas não tem com quem conversar.

Como resolver, passo a passo:

1. Abra o log de erros. No painel da hospedagem (cPanel, hPanel e parecidos) existe uma seção de logs. A resposta quase sempre está lá, com nome e sobrenome.
2. No WordPress, desative os plugins. Sem acesso ao painel? Pelo gerenciador de arquivos ou FTP, renomeie a pasta wp-content/plugins para plugins-off. Se o site voltar, reative um por um até achar o culpado.
3. Recrie o .htaccess. Renomeie o arquivo atual e, no painel do WordPress, salve de novo as configurações de links permanentes.
4. Aumente a memória do PHP. No wp-config.php, a linha define('WP_MEMORY_LIMIT', '256M'); costuma resolver; se a hospedagem tiver um teto menor, só ela pode subir.
5. Ligue o modo debug por alguns minutos. WP_DEBUG e WP_DEBUG_LOG no wp-config.php gravam o erro exato num arquivo. Desligue depois.

Regra de ouro: erro 500 quase nunca aparece do nada. Alguma coisa convidou ele.

Erro 502: o que é e como resolver

O erro 502 (Bad Gateway) significa que o intermediário entre o visitante e o servidor está funcionando, mas recebeu uma resposta inválida, ou nenhuma, de quem está atrás dele. No restaurante, é o garçom voltando da cozinha de mãos vazias: ele foi, bateu na porta e ninguém entregou o prato.

O que causa:

• A aplicação caiu ou está reiniciando. Um processo (PHP-FPM, Node, Python) que morre e não volta sozinho é a causa número um.
• Um deploy em andamento. Muitos 502 duram exatamente o tempo que a aplicação leva para subir de novo.
• Firewall ou plugin de segurança bloqueando o proxy. O servidor recusa o próprio garçom.
• Problema na hospedagem ou no CDN. Às vezes a cozinha está ótima e o garçom é que tropeçou.

Como resolver: confira se o serviço da aplicação está rodando e reinicie (na hospedagem compartilhada, um chamado ao suporte faz isso por você). E antes de caçar fantasma no seu código, abra a página de status da hospedagem e do CDN.

Erro 503: o que é e como resolver

O erro 503 (Service Unavailable) quer dizer que o servidor existe, mas agora não consegue atender: está sobrecarregado ou em manutenção. É o restaurante com a fila dobrando a esquina e a plaquinha "volto já" na porta.

É o único da família que às vezes é de propósito: muitos sites respondem 503 enquanto instalam uma atualização. O problema é quando ninguém planejou:

• Sua campanha deu certo demais. O tráfego da Black Friday, uma menção viral, e o servidor que aguentava 100 visitas recebe 10.000.
• O modo manutenção ficou ligado. No WordPress, uma atualização interrompida deixa um arquivo .maintenance na raiz do site, e a mensagem "temporariamente indisponível para manutenção" não sai mais.
• Limite de recursos da hospedagem. Em hospedagem compartilhada, quando o seu site passa da cota de CPU ou de processos, a própria hospedagem começa a responder 503.

Como resolver: apague o arquivo .maintenance se ele estiver lá, confira no painel da hospedagem se você bateu algum limite de recursos e ative cache (de página e, se der, um CDN) para que nem toda visita chegue até a cozinha. Se o pico é previsível, suba de plano antes da campanha, não durante.

Erro 504: o que é e como resolver

O erro 504 (Gateway Timeout) significa que o intermediário entregou o pedido ao servidor e cansou de esperar a resposta. A cozinha não morreu: está lenta. Para o cliente na mesa, dá na mesma.

Os suspeitos de sempre:

• Uma consulta lenta no banco de dados. Aquela busca que demora 40 segundos desde que a tabela cresceu.
• Um serviço externo devagar. O gateway de pagamento, o cálculo de frete ou uma API de terceiros engasgou, e o seu site leva a fama.
• Timeouts desalinhados. O proxy espera 60 segundos, o PHP tem max_execution_time de 30 e ninguém combinou nada.
• Um servidor que não dá mais conta. O plano contratado há três anos não aguenta o site de hoje.

Como resolver: descubra qual página ou tarefa está lenta (os logs e o painel da hospedagem mostram), otimize a consulta e ajuste os timeouts do proxy e do PHP para conversarem entre si. Aumentar o timeout ajuda a passar o sufoco, mas não conserta a lentidão.

503 x 504: qual a diferença?

Os dois parecem "o site não respondeu", mas contam histórias diferentes:

• 503: o servidor responde, e responde que não pode atender agora. A cozinha avisou que está lotada.
• 504: o servidor não respondeu a tempo. A cozinha ficou em silêncio e o garçom desistiu.

Por isso, no 503 você olha limites e modo manutenção, e no 504 você caça o que está demorando.

Perguntas frequentes

Erro 500 é culpa minha ou do site?

Se você é só o visitante, é do site. Erros 5xx acontecem no servidor, não no seu celular ou computador. Atualizar a página ou tentar em alguns minutos é tudo o que dá para fazer. Se você é o dono do site, aí sim é com você (ou com seu dev e sua hospedagem).

Quanto tempo dura um erro 503?

Depende da causa. Uma manutenção planejada costuma levar minutos. Um pico de tráfego dura enquanto o pico durar. Já um arquivo .maintenance esquecido no WordPress dura para sempre, até alguém apagar. Se o 503 passou de meia hora sem manutenção anunciada, trate como incidente.

Erro 502 no Cloudflare: o problema é do Cloudflare?

Nem sempre. Na maioria das vezes o Cloudflare (o garçom) está bem e o servidor de origem (a cozinha) é que não respondeu direito. A página de erro do Cloudflare mostra onde a corrente quebrou: se o problema estiver marcado no "Host", olhe para o seu servidor. Os erros 521 e 522 são outra conversa: são códigos próprios do Cloudflare para quando ele nem consegue conectar no seu servidor.

Erro 500 afeta o SEO do meu site?

Um erro rápido e isolado, não. Mas se o Google encontrar erro 5xx por horas ou dias seguidos, ele passa a visitar menos o site e pode tirar páginas do índice. Mais um motivo para descobrir o problema em minutos, não em dias.

Como descobrir um erro 5xx antes dos seus clientes

Agora a parte incômoda: erro de servidor não manda aviso prévio. Aparece às 2 da manhã, no pico de tráfego, ou bem no dia da campanha que você preparou o mês inteiro. Se você vive de loja virtual, cada minuto de erro é carrinho abandonado: vale conferir o que o monitoramento faz por um ecommerce.

A saída é não depender de sorte. Um serviço de monitoramento visita seu site de tempos em tempos, como um cliente de verdade. O OhSnap trata qualquer resposta HTTP 500 ou acima como site fora do ar e, antes de alertar, verifica de novo, para uma oscilação de rede não te acordar à toa. No plano Unlimited as verificações acontecem a cada 30 segundos, e os alertas chegam por email, SMS, WhatsApp, Slack ou Telegram: todos os canais estão na página de alertas.

E enquanto você conserta o problema, uma página de status pública conta aos seus usuários o que está acontecendo, antes de o "caiu?" lotar o seu suporte.

Comece antes do próximo susto

Você não precisa de orçamento para parar de descobrir os problemas por acidente: o plano gratuito do OhSnap inclui 5 monitores com verificações a cada 5 minutos e alertas por email e SMS, sem pagar nada. Erro de servidor, mais cedo ou mais tarde, acontece com todo mundo; até os restaurantes estrelados deixam o prato cair de vez em quando. A diferença entre um sufoco e uma crise é quem fica sabendo primeiro. Que o print do erro 500 nunca chegue até você mandado por um cliente.