Como corrigir atualização automática do WordPress que falha
O que é a atualização automática que falha?
O WordPress aplica atualizações em segundo plano: o agendador WP-Cron dispara o processo, o sistema baixa os arquivos novos e os grava sobre os antigos. Para isso, o PHP precisa ter permissão de escrita nos arquivos do site e um método de acesso ao sistema de arquivos. Quando a permissão é negada, o cron não roda ou a conexão com os servidores do WordPress.org falha, a atualização automática é abortada e o site fica numa versão desatualizada ou com um aviso de falha na tela de atualizações.
Como identificar
- Mensagem “The update cannot be installed because we will be unable to copy some files.” na tela de atualização.
- E-mail do WordPress com o assunto “An automatic update has failed” ou “Your site has been scheduled for an update”.
- A versão do núcleo, plugins ou temas continua antiga mesmo com a atualização automática ligada.
- A tela de atualização pede credenciais de FTP a cada tentativa, em vez de atualizar direto.
Como prevenir
- Mantenha pastas em 755 e arquivos em 644, com wp-content gravável pelo usuário do PHP
- Configure um cron real no servidor apontando para o wp-cron.php em sites de baixo tráfego
- Monitore o espaço em disco e libere a saída para api.wordpress.org no firewall do servidor
Causa
- Permissões de arquivo erradas em wp-content ou nos arquivos do núcleo, bloqueando a escrita do PHP.
- WP-Cron desativado ou sem disparar, então a atualização agendada em segundo plano nunca roda.
- Falta de acesso direto ao sistema de arquivos, fazendo o WordPress pedir FTP a cada atualização.
- Conexão com api.wordpress.org bloqueada por firewall, impedindo o download dos arquivos novos.
- Espaço em disco esgotado no servidor, sem onde gravar os arquivos baixados da atualização.
Como resolver
- Ligue o modo de depuração: edite o wp-config.php para registrar o erro real da atualização no log, em vez do aviso genérico na tela:
define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); - Force o método direto de arquivos: se o WordPress fica pedindo FTP, adicione a constante de método direto no wp-config.php para ele gravar os arquivos sem credenciais, quando a permissão permitir.
define('FS_METHOD', 'direct'); - Corrija as permissões: via FTP, ajuste as pastas para 755 e os arquivos para 644, e garanta que wp-content seja gravável pelo usuário do PHP. Permissão errada é a causa mais comum.
- Teste o WP-Cron: confirme se o cron está disparando. Se o site tem pouco tráfego, configure um cron real no servidor apontando para o wp-cron.php em vez de depender das visitas.
- Atualize manualmente: se a automática insistir em falhar, atualize pelo botão em Painel > Atualizações, ou via FTP substituindo as pastas wp-admin e wp-includes pela versão nova, sem tocar em wp-content.
// wp-config.php — destrava a atualizacao automatica.
// Coloque ANTES da linha "That's all, stop editing!".
define( 'FS_METHOD', 'direct' ); // grava arquivos sem pedir FTP
define( 'WP_AUTO_UPDATE_CORE', true ); // liga a atualizacao automatica do nucleo
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // registra a falha real em wp-content/debug.logPerguntas frequentes
Por que o WordPress pede FTP toda vez que tento atualizar?
Qual permissão de arquivo o WordPress precisa para atualizar sozinho?
A atualização automática depende do WP-Cron?
Recebi um e-mail de An automatic update has failed. O que faço?
É seguro usar FS_METHOD direct?
A atualização automática some com meu conteúdo se falhar?
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.
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 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.
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.
Como corrigir a Tela Branca da Morte (WSoD)
A Tela Branca da Morte (WSoD) é quando o site WordPress carrega uma página totalmente em branco, sem mensagem de erro. Quase sempre é um erro fatal de PHP escondido, causado por um plugin/tema com defeito ou pela memória PHP esgotada.
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.
