Site travado em manutenção no WordPress: como sair

Tipo Erro interno do WP

Nome do erro Como sair do modo de manutenção travado

Severidade Grave

Descrição O modo de manutenção travado acontece quando uma atualização de plugin, tema ou núcleo é interrompida no meio e o WordPress não chega a remover o arquivo .maintenance da raiz do site. Com esse arquivo presente, o site mostra a mensagem de manutenção a todos os visitantes até que o arquivo seja apagado manualmente.

O que é o modo de manutenção travado?

O modo de manutenção do WordPress é um estado temporário que o sistema ativa durante atualizações, criando um arquivo chamado .maintenance na raiz do site. Enquanto ele existe, o WordPress exibe a mensagem de manutenção para todo mundo. Normalmente o arquivo some sozinho ao fim da atualização; quando o processo trava (timeout, falta de memória ou aba fechada no meio), o .maintenance fica para trás e o site permanece travado em manutenção.

Como identificar

Mensagem “Briefly unavailable for scheduled maintenance. Check back in a minute.” para todos os visitantes.
Em sites em português, a mensagem “Indisponível por instantes para manutenção programada. Volte em um minuto.”
O site fica preso nessa tela por muito mais que um minuto, sem voltar sozinho.
O bloqueio surgiu logo após atualizar plugins/temas em lote ou após uma atualização interrompida.

Antes de começar: Faça backup antes de refazer atualizações que travaram. Apagar o .maintenance só tira a tela de manutenção; se a atualização ficou incompleta, ainda é preciso reinstalar o plugin ou tema afetado para não deixar arquivos quebrados no site.

Como prevenir

Atualize plugins e temas alguns por vez, não todos em lote, para o PHP não estourar o tempo no meio
Mantenha o max_execution_time e a memória adequados antes de grandes atualizações
Não feche a aba durante uma atualização e tenha backup automático para reverter se travar

Erros relacionados

Causa

Atualização de plugin, tema ou núcleo interrompida no meio (aba fechada, timeout ou perda de conexão)
Arquivo .maintenance deixado na raiz do site porque a atualização não terminou de removê-lo
Atualização em lote de muitos plugins de uma vez, estourando o tempo de execução do PHP
Falta de memória ou max_execution_time baixo abortando o processo antes da limpeza do .maintenance
Permissões que impediram o WordPress de apagar o arquivo .maintenance automaticamente

Como resolver

Conecte ao site via FTP: abra um cliente FTP (ou o gerenciador de arquivos da hospedagem) e vá até a raiz do site, onde ficam o wp-config.php e as pastas wp-admin, wp-content e wp-includes.
Apague o arquivo .maintenance: exclua o arquivo oculto .maintenance da raiz. Ative a exibição de arquivos ocultos no cliente FTP, porque o nome começa com ponto. Recarregue o site: ele volta na hora.
Verifique se a atualização terminou: no wp-admin, vá em Painel > Atualizações e confirme se o plugin/tema que estava atualizando ficou na versão certa. Refaça a atualização que travou, agora uma de cada vez.
Confira se algo quebrou: se o site voltar com erro fatal, é porque a atualização ficou pela metade. Reinstale o plugin/tema afetado pela versão completa para corrigir arquivos faltando.
Aumente limites se o erro reincidir: se o modo de manutenção voltar a travar, suba o max_execution_time e a memória, e atualize em lotes menores para o processo não estourar no meio.

PHP

// O modo de manutencao e controlado por um arquivo OCULTO na raiz do site:
//   /.maintenance
//
// Para sair: APAGUE esse arquivo via FTP (mostre arquivos ocultos).
//
// Conteudo tipico do arquivo (gerado pelo WordPress durante a atualizacao):
<?php $upgrading = 1718200000; // timestamp de quando a manutencao comecou

Perguntas frequentes

Onde fica o arquivo .maintenance?

Na raiz do site, no mesmo nível do wp-config.php e das pastas wp-admin, wp-content e wp-includes. Como o nome começa com ponto, ele é oculto: ative a exibição de arquivos ocultos no cliente FTP para vê-lo.

Apaguei o .maintenance e o site voltou, mas dá erro. Por quê?

A atualização que criou o arquivo travou no meio e deixou arquivos do plugin ou tema incompletos. Reinstale o item afetado pela versão completa para repor os arquivos que faltaram e o erro some.

Posso só esperar o modo de manutenção sair sozinho?

Em teoria o WordPress libera após 10 minutos pelo timestamp do arquivo, mas quando a atualização trava de vez o arquivo não é removido e o site fica preso. O caminho seguro é apagar o .maintenance via FTP.

Não tenho FTP. Como removo o arquivo?

Use o gerenciador de arquivos do painel da hospedagem (cPanel, Plesk ou similar). Ative a opção de mostrar arquivos ocultos, vá até a raiz do site e exclua o .maintenance por lá mesmo.

Por que o modo de manutenção travou logo após atualizar vários plugins?

Atualizar muitos plugins de uma vez pode estourar o tempo de execução do PHP. O processo é abortado antes de apagar o .maintenance e o site fica travado. Atualize em lotes menores para evitar.

Apagar o .maintenance é seguro?

Sim. O arquivo é apenas um sinalizador temporário que o próprio WordPress cria e apaga. Removê-lo não danifica o site; só encerra a tela de manutenção. Depois, confirme se a atualização que travou foi concluída.

Grave

Como corrigir mídia que não faz upload no WordPress

Quando o upload de mídia no WordPress falha, a imagem ou arquivo não chega à Biblioteca de Mídia. As causas mais comuns são permissões erradas na pasta wp-content/uploads, o limite de tamanho de upload do servidor abaixo do arquivo enviado, ou memória PHP insuficiente para processar a imagem.

Pro Atenção

Como corrigir o botão Adicionar Mídia que não funciona

Quando o botão Adicionar Mídia não funciona, ele para de abrir a janela da biblioteca ao ser clicado. Na quase totalidade dos casos é um conflito de JavaScript causado por um plugin, um tema ou um cache que interrompe o carregamento dos scripts da tela de edição.

Pro Grave

Como corrigir permalinks retornando 404

Permalinks retornando 404 é quando só a página inicial abre e todos os posts e páginas internas dão erro 404. Quase sempre as regras de reescrita do WordPress foram perdidas ou o .htaccess ficou sem as linhas que traduzem as URLs amigáveis para o WordPress.

Pro Atenção

Como corrigir widgets que desapareceram após atualização

Widgets que desapareceram no WordPress após uma atualização costumam ser efeito da tela de widgets em blocos, introduzida no WordPress 5.8. Os widgets continuam no banco; o que muda é a interface, e às vezes um tema FSE remove de vez as áreas de widget clássicas.

Pro Atenção

Como corrigir Another update is currently in progress

Another update in progress aparece quando uma atualização do núcleo do WordPress é interrompida e deixa uma trava registrada no banco de dados. Enquanto a opção core_updater.lock existir, o WordPress recusa qualquer nova atualização até a trava expirar ou ser apagada.

Grave

Como corrigir Publishing failed / Updating failed (REST API)

A falha ao publicar no WordPress (Publishing failed / Updating failed) acontece quando o editor de blocos não consegue falar com a REST API. O Gutenberg salva o post por uma chamada à REST API em /wp-json/; quando essa rota é bloqueada ou responde algo diferente de JSON, o editor exibe o erro mesmo com o conteúdo correto.

Setores

Extensões

Integrações

Como sair do modo de manutenção travado

O que é o modo de manutenção travado?

Como identificar

Como prevenir

Erros relacionados

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir mídia que não faz upload no WordPress

Como corrigir o botão Adicionar Mídia que não funciona

Como corrigir permalinks retornando 404

Como corrigir widgets que desapareceram após atualização

Como corrigir Another update is currently in progress

Como corrigir Publishing failed / Updating failed (REST API)

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos