Erro 503 Service Unavailable: o que é e como resolver

Entenda o erro 503 Service Unavailable num site WordPress com Nginx na VPS: o que o código significa, quatro causas na ordem de teste e como conferir a correção.

Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 9 min de leitura

O erro 503 service unavailable significa que o servidor está no ar, mas avisou que não pode atender ao pedido agora, por manutenção ou sobrecarga. É um aviso temporário, e a causa pode estar no log do Nginx, na pasta do site ou nos recursos do servidor.

Este guia é para quem tem um site WordPress numa VPS com Nginx e viu a tela de 503. Primeiro vem o que o código quer dizer e o que cabe ao visitante. Depois, quatro causas, na ordem em que vale a pena testar, e como conferir o resultado. Os nomes seudominio.com.br e /var/www/seudominio.com.br são exemplos. Troque pelo endereço e pelo caminho do seu site.

O que significa o erro 503 Service Unavailable

Segundo a MDN, o código de resposta de erro de servidor 503 Service Unavailable do HTTP indica que o servidor não está pronto para lidar com a requisição. A MDN cita como causas comuns um servidor que está em manutenção ou sobrecarregado.

A MDN diz também que esse código deve ser usado para condições temporárias. O cabeçalho Retry-After deve, se possível, trazer o tempo estimado para o serviço voltar, e a resposta deve vir com uma página fácil de entender explicando o problema. A MDN ainda informa que a resposta 503 não deve ser guardada em cache.

Em linguagem simples: o servidor está de pé, mas respondeu "agora não dá". Isso o separa de outros erros que você pode ver no mesmo site:

• 500: algo quebrou ao processar o pedido. O guia Erro 500 Internal Server Error: como resolver no site mostra como investigar.
• 502: o programa por trás do Nginx respondeu errado ou não respondeu. Veja Erro 502 Bad Gateway: o que é e como resolver na VPS.
• 504: a resposta demorou demais. O guia de Erro 504 Gateway Timeout trata desse caso.
• 503: o servidor avisou que, neste momento, não vai atender.

Como mais de uma situação pode gerar o 503, não existe uma causa única. Por isso o diagnóstico segue uma ordem: das causas mais simples de conferir para as que pedem mais atenção.

Se você é visitante ou dono do site

Se você só está visitando o site de outra pessoa, o que cabe a você é tentar de novo mais tarde. Como a MDN descreve o 503 como uma condição temporária, vale tentar de novo daqui a algum tempo.

Se o site é seu, confirme primeiro o código que o servidor está devolvendo. O comando abaixo mostra só os cabeçalhos da resposta:

curl -I https://seudominio.com.br

Olhe a primeira linha, que traz o status (por exemplo, HTTP/2 503). Se houver uma linha retry-after, ela mostra quanto tempo o servidor pede para você esperar. Essa linha ajuda a descobrir de onde vem o aviso, como você verá na primeira causa.

Causa 1: WordPress preso em modo de manutenção

Segundo a documentação do WordPress, ao atualizar o núcleo, um plugin ou um tema, o WordPress cria sozinho um arquivo chamado .maintenance na pasta principal do site. Enquanto ele existir, o visitante vê a mensagem "Briefly unavailable for scheduled maintenance. Check back in a minute." Em português, ela pode aparecer como "Temporariamente indisponível para manutenção programada. Volte daqui a um minuto."

A função wp_maintenance do WordPress responde com o status 503 e com o cabeçalho Retry-After: 600, que equivale a 600 segundos, ou 10 minutos. Se a atualização foi interrompida, o arquivo pode não ter sido apagado, e o site continua em manutenção. A solução da documentação é apagar o arquivo .maintenance da pasta principal do site.

O ponto na frente do nome deixa o arquivo oculto, por isso o comando para listar usa a opção -a. Troque o caminho pelo da pasta do seu site:

ls -la /var/www/seudominio.com.br

Se o arquivo .maintenance aparecer na lista, apague-o:

sudo rm /var/www/seudominio.com.br/.maintenance

Depois, recarregue o site e confira se a atualização que estava em andamento terminou. O roteiro de Como atualizar o WordPress com segurança: passo a passo mostra como repetir a atualização com cuidado.

Causa 2: limite de pedidos do Nginx

A documentação do Nginx descreve dois módulos que recusam o excesso de tráfego: o limit_req, que limita pedidos por segundo, e o limit_conn, que limita conexões ao mesmo tempo. Quando um visitante passa do limite, o Nginx recusa o pedido e, por padrão, responde 503. Os padrões são limit_req_status 503; e limit_conn_status 503;.

Um exemplo da própria documentação cria uma zona de 10 MB chamada "one", com média de até 1 pedido por segundo para cada endereço:

limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

As recusas vão para o log de erro com o nível error, que é o padrão do limit_req_log_level. Para achar, procure as linhas com "limiting requests" ou "limiting connections":

sudo grep -E "limiting (requests|connections)" /var/log/nginx/error.log | tail -n 20

Se aparecerem linhas assim, o Nginx está recusando visitantes de propósito. Quando o limite está apertado demais para o tráfego real do site, ajuste o rate ou o burst na configuração. Antes de aplicar, teste a sintaxe:

sudo nginx -t

Se o teste não apontar erro, recarregue o Nginx:

sudo systemctl reload nginx

Se o nginx -t apontar um erro, corrija a linha indicada antes de recarregar. Se o log não tiver nenhuma linha de limite, essa não é a causa, e você pode seguir para a próxima.

Quer um servidor para hospedar o seu site? Os planos de VPS saem a partir de R$ 17,00/mês, no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Causa 3: servidor sobrecarregado

A segunda causa que a MDN cita é o servidor sobrecarregado: o processador, a memória ou o disco no limite. Nesse caso, o site pode não conseguir atender os pedidos.

Para conferir a memória, use o comando abaixo. A opção -h mostra os valores em unidades fáceis de ler:

free -h

Para conferir o disco, use:

df -h

Se alguma partição estiver cheia, o guia Disco cheio na VPS: como liberar espaço no Ubuntu mostra como achar o que ocupa espaço. Se a memória estiver quase toda em uso, o servidor pode ter ficado pequeno para o site, e o guia VPS lento? O que fazer: 6 sinais de que ficou pequeno ajuda a decidir se é hora de trocar de plano.

Note que a sobrecarga é um sintoma. Procure o que consome os recursos antes de agir. Trocar de plano sem entender a causa pode não resolver o problema.

Causa 4: manutenção de propósito

Às vezes o 503 é intencional. Você mesmo pode responder 503 durante uma manutenção, e a diretiva return do Nginx aceita um código de status. Dentro do bloco server do site, a linha é esta:

return 503;

Com ela ativa, o Nginx responde 503 aos pedidos desse site. Se foi você ou outra pessoa da equipe que ligou a manutenção e esqueceu de desligar, o site fica fora do ar até alguém remover a linha. Procure por ela no arquivo de configuração do site, remova, teste e recarregue:

sudo nginx -t

sudo systemctl reload nginx

Se for fazer uma manutenção de verdade, siga o que a MDN pede para o 503: informe o tempo estimado no cabeçalho Retry-After e mostre uma página que explique o problema. No Nginx, a diretiva error_page 503 permite apontar para uma página própria com essa explicação.

O que o Google faz com o erro 503

Para quem tem um site que aparece nas buscas, o 503 tem um efeito a mais. Segundo o Google Search Central, os erros de servidor 5xx e 429 solicitam aos rastreadores do Google que desacelerem temporariamente o rastreamento.

O Google informa que, se o erro continuar, os URLs já indexados são preservados no índice, mas depois são descartados. Quando o servidor volta a atender os pedidos, o Google aumenta gradualmente a taxa de rastreamento do site. Por isso vale resolver o 503 sem demora e não deixar o site com o aviso por tempo indeterminado.

Conferir se o erro 503 foi resolvido

Depois de cada correção, repita o teste do início:

curl -I https://seudominio.com.br

Se a primeira linha mostrar HTTP/2 200, o servidor voltou a atender. Abra também o site no navegador, em uma janela anônima, para conferir a página de verdade. Se o 503 continuar, volte ao log do Nginx e veja se a mensagem mudou.

Já escolheu o endereço do seu site? Registre o seu domínio na Eleven Host. Registrar domínio

Perguntas frequentes

O erro 503 é problema do meu navegador ou da minha internet?

Não. Segundo a MDN, o 503 indica que o servidor não está pronto para lidar com a requisição. A origem está no servidor ou no site, e o visitante só pode tentar de novo mais tarde.

O erro 503 é temporário?

A MDN diz que ele deve ser usado para condições temporárias, como manutenção ou sobrecarga. Se ele persistir, procure a causa pelos passos deste guia.

O que fazer quando o WordPress mostra "Temporariamente indisponível para manutenção programada"?

Segundo a documentação do WordPress, a atualização pode ter sido interrompida e o arquivo .maintenance pode não ter sido apagado. Apague esse arquivo da pasta principal do site e confira se a atualização terminou.

O erro 503 prejudica o site no Google?

O Google informa que os erros 5xx fazem os rastreadores desacelerarem o rastreamento por um tempo. Se o erro continuar, os URLs já indexados são descartados do índice depois de algum tempo. Quando o servidor volta, o Google aumenta o ritmo aos poucos.