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

Tipo Erro interno do WP

Nome do erro Modo de manutenção travado EN: Briefly unavailable for scheduled maintenance

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

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.

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.

Atenção

Como corrigir Could not create directory no WordPress

Could not create directory aparece quando o WordPress tenta criar uma pasta dentro de wp-content e o servidor recusa por falta de permissão de escrita. É comum ao instalar ou atualizar plugins e temas, quando a pasta wp-content/upgrade ou wp-content/plugins está com dono ou permissão errados.

Atenção

Como corrigir Destination folder already exists no WordPress

Destination folder already exists aparece quando você instala um plugin ou tema cuja pasta de destino já existe em wp-content. O WordPress se recusa a sobrescrever a pasta existente e interrompe a instalação. Costuma ocorrer após uma instalação ou atualização anterior que falhou no meio e deixou a pasta para trás.

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.

Atenção

Como corrigir The link you followed has expired

O link que você seguiu expirou aparece quase sempre ao subir um tema ou plugin pesado pelo painel, quando o arquivo passa do limite de upload do servidor. O WordPress aborta o envio e devolve a mensagem genérica de link expirado, em vez do erro real de tamanho.

Atenção

Como corrigir o loop Update WordPress Database

O loop Update WordPress Database acontece quando o WordPress pede para atualizar o banco a cada visita e a tela nunca é superada, mesmo depois de clicar no botão. Em geral é causado por cache servindo a tela antiga ou por um descompasso na versão do banco que a rotina de atualização não consegue gravar.

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

Causa

Como resolver

Perguntas frequentes

Itens relacionados

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

Como corrigir Could not create directory no WordPress

Como corrigir Destination folder already exists no WordPress

Como corrigir Publishing failed / Updating failed (REST API)

Como corrigir The link you followed has expired

Como corrigir o loop Update WordPress Database

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