O que significa 503 Service Unavailable
Um 503 comunica indisponibilidade temporária. Ele não é um substituto genérico para erro de aplicação, página inexistente, controle de acesso ou uma decisão de desativação permanente. O cabeçalho Retry-After pode indicar quando uma nova tentativa faz sentido, mas não garante o comportamento do rastreador nem a permanência no índice.
Regra de decisão e evidências
Use 503 apenas para uma condição operacional delimitada e restaure as respostas normais assim que a condição for resolvida. Uma exclusão permanente precisa de uma decisão própria, com 404 ou 410; um defeito que deveria ser corrigido não deve ser reclassificado de forma cosmética como manutenção planejada.
Fluxo prático
HTTP/1.1 503 Service Unavailable
Retry-After: 3600
Cache-Control: no-storeA resposta de manutenção deve ser testada pelo caminho de borda (edge) que visitantes e rastreadores usam. Verifique uma rota normal, um asset estático e a rota de recuperação depois que a janela de manutenção terminar; um proxy reverso ou um cache pode continuar servindo a resposta temporária mesmo com a aplicação já saudável.
- Defina a janela de manutenção e as rotas que realmente ficarão indisponíveis.
- Sirva uma resposta de manutenção simples, voltada ao usuário, com status 503.
- Adicione um valor realista de Retry-After somente se a janela estimada de recuperação for conhecida.
- Monitore uma URL principal, os recursos críticos e a resposta depois que a manutenção terminar.
- Registre o horário de início e de término e confirme que volta a resposta 2xx normal ou o redirecionamento pretendido.
Verificação e erros comuns
Use um cliente HTTP fora da interface da aplicação para capturar o status e o cabeçalho Retry-After. Depois, verifique uma rota pública principal após a recuperação; uma página de manutenção que continue em cache com status 503 é um defeito operacional.