Erro 503 Service Unavailable: o que significa e como resolver

Resposta rápida

Erro 503 Service Unavailable significa que o servidor ou uma camada intermediária está temporariamente sem condições de atender a requisição. As causas mais comuns são sobrecarga, manutenção e falta de destinos disponíveis atrás de um balanceador. O código indica uma condição temporária, mas não informa sozinho qual componente falhou.

Se você é visitante, aguarde o tempo indicado, atualize apenas uma vez e confirme se a falha aparece fora da sua rede. Se administra o serviço, identifique quem gerou a resposta, consulte métricas e logs e só reabra o tráfego depois de recuperar capacidade ou destinos saudáveis.

O que o visitante pode fazer

Um 503 normalmente não é corrigido limpando histórico, trocando DNS ou reinstalando o navegador. Essas ações não aumentam a capacidade do servidor. Antes de mudar a configuração do aparelho, confirme se o erro também aparece em outra rede e para outras páginas do mesmo serviço.

• Anote o horário, o endereço exato e a mensagem exibida na página de erro.
• Aguarde o prazo informado em Retry-After, quando o site apresentar essa orientação.
• Atualize uma vez e teste uma página diferente do mesmo domínio.
• Compare o resultado no Wi-Fi e na rede móvel sem repetir uma transação.
• Consulte o status oficial do serviço e faça uma verificação externa do endereço.
• Em pagamento, pedido ou formulário, confira o histórico antes de enviar novamente.

503, 502, 504 e 429 são falhas diferentes

O 503 informa indisponibilidade temporária. O 502 ocorre quando um gateway recebe uma resposta inválida do servidor seguinte. O 504 aparece quando esse gateway não recebe a resposta no tempo esperado. O 429 indica solicitações demais dentro do limite aplicado ao cliente.

Os quatro códigos podem surgir durante um pico, mas pedem diagnósticos diferentes. Aumentar timeout não cria capacidade, reiniciar a aplicação não corrige um grupo de destinos vazio e insistir em novas tentativas pode ampliar a sobrecarga.

Como descobrir quem gerou o 503

A página visível no navegador pode ter sido gerada pela aplicação, servidor web, balanceador, CDN ou plataforma de nuvem. Compare corpo, cabeçalhos e identificadores da resposta com os registros do mesmo horário. Uma página com a marca de um provedor é uma pista, não uma prova suficiente da causa final.

• Use curl -I seguido da URL para registrar status, data, servidor, Retry-After e identificadores públicos.
• Compare a rota pública com um teste autorizado diretamente na origem, sem expor o endereço da origem.
• Cruze o horário com logs da CDN, balanceador, servidor web, aplicação e banco de dados.
• Verifique se todas as rotas falham ou se o 503 aparece apenas num endpoint, região ou conta.
• Confirme no painel do provedor se existe incidente ou manutenção em andamento.

Checklist para quem administra o site

O objetivo imediato é reduzir pressão e recuperar capacidade sem esconder a evidência. Preserve uma amostra das respostas e dos logs antes de reiniciar componentes. Depois, procure saturação, filas, limites e falhas de dependências no mesmo intervalo.

• Confira CPU, memória, conexões, workers, filas, latência e taxa de erros.
• Verifique reinicializações, falhas de saúde e quantidade de réplicas disponíveis.
• Teste banco de dados, cache, filas e APIs essenciais com timeouts controlados.
• Revise mudanças de configuração, implantação e escala ocorridas antes do primeiro 503.
• Reduza trabalho não essencial, limite concorrência e aplique backpressure quando a arquitetura permitir.
• Recupere destinos saudáveis antes de devolver tráfego ao balanceador.
• Valide mais de uma rota e acompanhe erros e latência após a recuperação.

Quando o site usa Cloudflare

A documentação da Cloudflare diferencia respostas 503 geradas pela própria rede de respostas originadas no servidor do site. Quando o corpo menciona cloudflare ou cloudflare-nginx, a orientação é registrar domínio, horário com fuso e a saída de /cdn-cgi/trace obtida no navegador afetado.

Quando a origem gerou o 503, a investigação deve começar nos logs e nas métricas do servidor, procurando saturação de CPU ou memória, esgotamento do conjunto de conexões e modo de manutenção. Eventos de segurança também podem explicar uma mitigação ativa.

Quando existe balanceador ou CloudFront

Na AWS Application Load Balancer, um 503 pode ocorrer quando o grupo não tem destinos registrados ou quando todos estão indisponíveis para receber a solicitação. No CloudFront, o código costuma apontar para falta de capacidade ou indisponibilidade na origem, embora também possa envolver funções executadas na borda.

Não basta confirmar que uma máquina está ligada. Verifique o estado dos destinos, a porta, o caminho do health check, a resposta esperada e se a aplicação consegue atender a taxa real de requisições.

Como tratar 503 em APIs e automações

O RFC 9110 permite que a resposta 503 inclua Retry-After para sugerir quanto tempo o cliente deve esperar. Quando ele existir, respeite o valor. Sem essa indicação, use atraso progressivo com jitter, quantidade máxima de tentativas e um prazo total para desistir com erro claro.

Não repita automaticamente pagamentos, criação de pedidos, publicação ou outras operações com efeito real sem suporte a idempotência. Agentes e filas devem compartilhar o controle de concorrência para evitar que várias instâncias retomem ao mesmo tempo e criem outro pico.

Manutenção, 503 e Google

Para uma indisponibilidade planejada de um ou dois dias, o Google recomenda uma página informativa que responda 503, use HTML estático leve e inclua Retry-After quando houver uma previsão confiável. O arquivo robots.txt deve continuar acessível, sem devolver 503.

Erros 5xx fazem os rastreadores reduzirem temporariamente a frequência de acesso. Se persistirem por vários dias, URLs já indexadas podem acabar removidas. Por isso, o 503 não deve permanecer depois que a manutenção ou a sobrecarga terminar.

Limites do diagnóstico externo

Um teste público confirma a resposta observada naquela rota, horário e região. Ele não enxerga logs privados, capacidade do banco, estado de contêineres nem health checks internos. Um resultado 200 também não descarta um 503 intermitente ou restrito a uma conta.

Este guia foi verificado em 14 de setembro de 2026. Páginas de status mostram disponibilidade agregada e podem atualizar depois do início de uma falha. Preserve a evidência técnica e evite atribuir o erro a um provedor sem cruzar os dados.

Próxima ação útil

Abra o diagnóstico web do Caiu ou Não? e registre o código recebido. Se você administra o domínio, compare esse horário com métricas e logs e identifique qual camada devolveu o 503. Se é visitante, acompanhe o status oficial, respeite a espera indicada e não repita transações até o serviço normalizar.

Fontes consultadas

Os links abaixo servem para conferir conceitos, orientações oficiais e o critério editorial usado neste conteúdo.

• 503 Service UnavailableMDN Web Docs
• RFC 9110, seção 503RFC Editor
• Error 503Cloudflare Docs
• HTTP 503 no Application Load BalancerAmazon Web Services
• HTTP 503 no Amazon CloudFrontAmazon Web Services
• Pausar um site temporariamenteGoogle Search Central
• Como códigos HTTP afetam o GoogleGoogle Search Central