HTTP 503 Service Unavailable (Serviço indisponível)
O servidor não consegue atender agora, por sobrecarga ou manutenção.
Ficha rápida
| Código | 503 |
|---|---|
| Nome oficial (em inglês) | Service Unavailable |
| Nome em português | Serviço indisponível |
| Grupo | Erro do servidor (5xx) |
| Definido em | RFC 9110, Section 15.6.4 |
| Quem costuma gerar | O servidor, ou um gateway ou proxy no caminho, quando a falha está do lado do serviço. |
O que significa
O servidor não consegue atender a requisição agora, por sobrecarga ou manutenção programada. É uma condição temporária, e a resposta pode trazer o cabeçalho Retry-After com uma estimativa de quando voltar.
Quando o servidor devolve esse código
- Manutenção programada.
- Sobrecarga que o servidor não aguenta.
Problemas comuns
- Pico de acessos além da capacidade.
- Deploy em andamento.
- Dependência essencial fora do ar.
Como resolver
- Quem consome: espere e tente de novo, respeitando o Retry-After.
- Quem mantém: informe o tempo previsto de volta e escale a capacidade se for sobrecarga.
- Use 503 em manutenção, em vez de 500, para sinalizar que é temporário.
Em automações e integrações
Respeite o cabeçalho Retry-After quando ele existir. Em uma manutenção prolongada, agende uma nova execução do fluxo em vez de insistir em repetições curtas.
Não confunda com outros códigos
Não confunda com 500 (erro genérico inesperado) nem com 429 (limite de requisições do seu cliente).
Exemplo de resposta
HTTP/1.1 503 Service Unavailable Retry-After: 120
O exemplo é ilustrativo: o corpo e os cabeçalhos reais mudam de servidor para servidor. O código e o nome seguem o padrão HTTP.
Perguntas frequentes
503 ou 500?
O 503 diz que a indisponibilidade é temporária e conhecida. O 500 é um erro genérico inesperado.
Buscadores penalizam um 503?
Um 503 curto sinaliza que o site volta, o que é melhor que um erro genérico.