Como corrigir o loop Update WordPress Database
O que é o loop Update WordPress Database?
Depois de atualizar o core, o WordPress compara a versão do banco armazenada na opção db_version com a versão que o código espera. Quando elas diferem, ele mostra a tela ‘O WordPress precisa atualizar seu banco de dados’ e roda a rotina wp_upgrade ao clicar no botão. No loop, essa rotina termina mas a nova versão não é gravada (ou a tela vem do cache), então o WordPress acha que ainda precisa atualizar e mostra a tela de novo, a cada visita, prendendo o site nesse passo.
Como identificar
- A tela “O WordPress precisa atualizar seu banco de dados” reaparece toda vez, mesmo após clicar em “Atualizar banco de dados do WordPress”.
- Em inglês, a mensagem “Update WordPress Database” volta em loop a cada acesso ao site ou ao painel.
- Após clicar e ver “Atualização concluída”, a tela de atualização volta no próximo carregamento.
- O loop começou logo depois de uma atualização do core do WordPress ou de uma migração de servidor.
Como prevenir
- Antes de atualizar o core, limpe o cache de página e o do CDN para a tela de upgrade não ser cacheada
- Em sites com Redis ou Memcached, esvazie o object cache logo após cada atualização do WordPress
- Após migrar de servidor, confirme que a db_version do banco bate com a versão do core instalado
Causa
- Plugin de cache de página ou CDN servindo a versão em cache da tela de atualização, que nunca reflete o banco já atualizado.
- Object cache persistente (Redis ou Memcached) com a opção db_version antiga em memória, ignorando o valor já gravado no banco.
- Opção db_version na tabela wp_options não sendo atualizada por permissão de escrita insuficiente no banco.
- Migração que trouxe um banco com db_version diferente da versão do core instalado no novo servidor.
- Tabela wp_options corrompida, impedindo a gravação do novo número de versão ao fim da rotina de upgrade.
Como resolver
- Limpe todos os caches: limpe o cache do plugin de cache, o cache do CDN (como Cloudflare) e o cache do navegador. Como a tela de atualização costuma ser cacheada, isso sozinho resolve boa parte dos loops.
- Esvazie o object cache, se houver: se o site usa Redis ou Memcached, esvazie o object cache. A opção db_version pode estar presa em memória com o valor antigo, mesmo já atualizada no banco.
- Force a rotina de atualização pela URL: acesse diretamente seudominio.com/wp-admin/upgrade.php?step=1 no navegador. Essa URL dispara a rotina de upgrade do core sem depender da tela em cache.
- Confira a db_version no banco: no phpMyAdmin, abra a tabela wp_options e localize a linha option_name = 'db_version'. Compare o valor com o esperado pela sua versão do WordPress e ajuste se estiver claramente defasado.
- Desative o cache temporariamente: se o loop persistir, adicione no wp-config.php a constante que desliga o cache (veja o bloco de código), complete a atualização e só depois reative o cache.
// wp-config.php - desliga o cache temporariamente para quebrar o loop.
// Coloque ANTES da linha "That's all, stop editing!".
define( 'WP_CACHE', false );
// Se usa object cache persistente (Redis/Memcached) e o problema continua,
// desative o plugin de object cache removendo o arquivo:
// wp-content/object-cache.php
// depois acesse wp-admin/upgrade.php?step=1 e reative o cache no fim.Perguntas frequentes
O que é a tela Update WordPress Database?
Por que a tela volta mesmo depois de eu clicar no botão?
Limpar o cache realmente resolve o loop?
Para que serve a URL upgrade.php?step=1?
Onde fica a versão do banco no WordPress?
Posso editar a db_version direto no banco?
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.
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 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 editor de blocos (Gutenberg) que não carrega
Quando o Gutenberg não carrega, o editor de blocos abre em branco, fica girando ou cai para o Editor Clássico. A causa quase sempre é um erro de JavaScript: cache antigo, minificação que quebra os scripts do editor ou conflito com outro plugin/tema que interrompe a carga da interface.
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 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.
