# Como sair do modo de manutenção travado

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

- [Como corrigir Another update is currently in progress](https://full.services/wp-fixer/corrigir-another-update-in-progress-wordpress/)
- [Como corrigir Publishing failed / Updating failed (REST API)](https://full.services/wp-fixer/corrigir-publishing-failed-rest-api-wordpress/)
- [Como corrigir o editor de blocos (Gutenberg) que não carrega](https://full.services/wp-fixer/corrigir-gutenberg-nao-carrega-wordpress/)

## 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

1. 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.
2. 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.
3. 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.
4. 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.
5. 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.

## Código

```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.

**Fonte:** [WordPress.org — Common WordPress Errors](https://wordpress.org/documentation/article/common-wordpress-errors/)