Como sair do modo de manutenção travado
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.
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.
// 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 comecouPerguntas frequentes
Onde fica o arquivo .maintenance?
Apaguei o .maintenance e o site voltou, mas dá erro. Por quê?
Posso só esperar o modo de manutenção sair sozinho?
Não tenho FTP. Como removo o arquivo?
Por que o modo de manutenção travou logo após atualizar vários plugins?
Apagar o .maintenance é seguro?
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.
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.
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.
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.
Como corrigir atualização automática do WordPress que falha
A atualização automática falha quando o WordPress não consegue concluir sozinho a atualização de núcleo, plugins ou temas. As causas mais comuns são permissões de arquivo que bloqueiam a escrita, o WP-Cron que não dispara e a falta de acesso direto ao sistema de arquivos do servidor.
Como corrigir Missing a temporary folder
Missing a temporary folder aparece quando o PHP não encontra a pasta temporária onde guarda os arquivos durante um upload. Sem esse diretório, ou sem permissão de escrita nele, o WordPress não consegue receber imagens, plugins ou temas e devolve esse erro.
