503 Service Unavailable (você também verá "Serviço Temporariamente Indisponível") significa que o servidor está no ar mas não pode atender sua requisição agora. É um código 5xx, mas diferente de um 500 é explicitamente temporário — o servidor pede que você volte.
O que causa um 503
| Causa | O que acontece |
|---|---|
| Sobrecarga | Mais tráfego do que a capacidade atual atende |
| Modo manutenção | A app é tirada do ar de propósito |
| Limites de recursos | Sem workers, memória ou conexões de DB |
| Escalonamento lento | O autoscaling não alcançou o pico |
| Dependência fora | Um serviço requerido (DB, cache, API) não está |
503 vs 502 vs 500
- 503 → "Estou no ar mas não posso te atender agora" (sobrecarga/manutenção).
- 502 → "Um servidor do qual dependo me deu uma resposta inválida."
- 500 → "Algo no meu código lançou um erro inesperado."
Como corrigir — como visitante
- Espere um minuto e recarregue — o 503 é temporário por design.
- Se houver header
Retry-After, é o tempo a esperar.
Como corrigir — como desenvolvedor
- É manutenção? Revise o flag de maintenance ou deploy.
- Capacidade: CPU, memória, workers, pool de conexões sob carga.
- Escale; confirme que os limiares de autoscaling reagem a tempo.
- Revise dependências (DB no limite, API downstream).
- Envie
Retry-Afterpara clientes e crawlers não te martelarem.
O Nurbak Watch checa seus endpoints a cada minuto de várias regiões e te avisa de um spike de 503 — assim você escala antes dos tickets chegarem.