--- title: "Como corrigir o loop Update WordPress Database" url: https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/ date: 2026-06-13 author: "Clayton Margiotti" --- # 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. **Antes de começar:** Antes de editar a opção db_version no phpMyAdmin, exporte um backup da tabela wp_options. Gravar um número de versão errado pode disparar rotinas de upgrade indevidas ou deixar o site preso numa versão de banco incompatível. ## 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 ## Erros relacionados - [Como corrigir Another update is currently in progress](https://full.services/wp-fixer/corrigir-another-update-in-progress-wordpress/) - [Como corrigir atualização automática do WordPress que falha](https://full.services/wp-fixer/corrigir-atualizacao-automatica-falha-wordpress/) - [Como limpar a tabela wp_options inchada (autoload)](https://full.services/wp-fixer/limpar-wp-options-autoload-wordpress/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#article", "headline": "Como corrigir o loop Update WordPress Database", "url": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/", "inLanguage": "pt-BR", "datePublished": "2026-06-13T23:45:47-03:00", "dateModified": "2026-06-13T23:45:47-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": true, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "Erro interno do WP" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/" }, "wordCount": 561, "description": "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.", "articleSection": "Erro interno do WP", "keywords": "db_version wordpress, limpar cache update database wordpress, site preso atualizar banco wordpress, update wordpress database necessario loop, wordpress pede atualizar banco toda hora", "proficiencyLevel": "Advanced", "citation": { "@type": "CreativeWork", "url": "https://developer.wordpress.org/reference/functions/wp_upgrade/", "name": "WordPress Developer Resources — wp_upgrade()" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o loop Update WordPress Database", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/", "isAccessibleForFree": true, "text": "// wp-config.php - desliga o cache temporariamente para quebrar o loop.\n// Coloque ANTES da linha \"That's all, stop editing!\".\ndefine( 'WP_CACHE', false );\n\n// Se usa object cache persistente (Redis/Memcached) e o problema continua,\n// desative o plugin de object cache removendo o arquivo:\n// wp-content/object-cache.php\n// depois acesse wp-admin/upgrade.php?step=1 e reative o cache no fim." } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq-q1", "name": "O que é a tela Update WordPress Database?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "É a tela que o WordPress mostra quando a versão do banco gravada na opção db_version difere da versão que o código instalado espera. Ela roda a rotina que ajusta a estrutura do banco para a nova versão. Normalmente aparece uma vez após atualizar o core.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq-q2", "name": "Por que a tela volta mesmo depois de eu clicar no botão?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque, no loop, ou a tela vem do cache (e não reflete o banco já atualizado), ou a nova db_version não é gravada por causa de object cache em memória ou permissão de escrita. O WordPress continua achando que precisa atualizar e mostra a tela de novo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq-q3", "name": "Limpar o cache realmente resolve o loop?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na maioria dos casos sim. A tela de atualização costuma ser cacheada pelo plugin de cache ou pelo CDN, então você vê uma cópia antiga mesmo após o banco já estar atualizado. Limpar todos os caches faz o site voltar a servir a página correta.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq-q4", "name": "Para que serve a URL upgrade.php?step=1?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Ela dispara diretamente a rotina de atualização do banco do core, sem passar pela tela que pode estar em cache. Acessar seudominio.com/wp-admin/upgrade.php?step=1 força o processo a rodar de novo de forma limpa e costuma concluir a atualização travada.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq-q5", "name": "Onde fica a versão do banco no WordPress?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na tabela wp_options, na linha em que option_name é 'db_version'. O número ali precisa corresponder à versão esperada pela sua instalação do WordPress. Se ele estiver defasado e não atualizar sozinho, é o que mantém o site preso na tela de atualização.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#faq-q6", "name": "Posso editar a db_version direto no banco?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode, com cuidado e backup antes. No phpMyAdmin, ajustar o valor de db_version na wp_options para o número correto pode quebrar o loop. Mas grave o número certo: um valor errado dispara rotinas de upgrade indevidas ou deixa o banco numa versão incompatível.", "author": { "@id": "https://full.services/#org" } } } ] }, { "@type": "HowTo", "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#howto", "name": "Como corrigir o loop Update WordPress Database", "inLanguage": "pt-BR", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#article" }, "isAccessibleForFree": true, "step": [ { "@type": "HowToStep", "position": 1, "name": "Limpe todos os caches", "text": "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.", "url": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#secao-solucao" }, { "@type": "HowToStep", "position": 2, "name": "Esvazie o object cache, se houver", "text": "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.", "url": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#secao-solucao" }, { "@type": "HowToStep", "position": 3, "name": "Force a rotina de atualização pela URL", "text": "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.", "url": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#secao-solucao" }, { "@type": "HowToStep", "position": 4, "name": "Confira a db_version no banco", "text": "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.", "url": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#secao-solucao" }, { "@type": "HowToStep", "position": 5, "name": "Desative o cache temporariamente", "text": "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.", "url": "https://full.services/wp-fixer/corrigir-update-database-loop-wordpress/#secao-solucao" } ], "description": "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." } ] } ```