--- title: "Corrigir atualizacao WordPress erro: Guia em 6 passos" description: "A mensagem 'atualização falhou' ou 'falha ao publicar' aparece quando o editor de blocos do WordPress não consegue falar com a REST API do site." url: https://full.services/corrigir-atualizacao-wordpress-erro/ date: 2026-06-26 author: "Clayton Margiotti" --- # Corrigir atualizacao WordPress erro: Guia em 6 passos Para **corrigir atualizacao WordPress erro** de falha na publicação, restaure a conexão entre o editor de blocos e a REST API. Segundo a [WordPress Developer Docs](https://developer.wordpress.org/rest-api/) (2026), a REST API é a fundação do editor de blocos. No suporte da FULL, a maioria dos casos vem de plugin ou firewall que bloqueia essa rota. Diagnostique a origem antes de mexer no código. A mensagem "atualização falhou" ou "falha ao publicar" aparece quando o editor de blocos do WordPress não consegue falar com a REST API do site. Este guia mostra como corrigir atualizacao WordPress erro de forma metódica, do diagnóstico rápido até a correção definitiva, sem reinstalar nada. A causa quase nunca está no seu texto: está na rota `/wp-json/`, num plugin de segurança, num limite de PHP ou numa regra de firewall do servidor. A gente vê esse padrão todo dia no suporte da FULL, e o erro some quando você trata a origem certa. Consulte também os [guias de erros comuns do WordPress da FULL](https://full.services/erros-wordpress/) para casos vizinhos. --- ## Diagnóstico rápido: Sintoma, causa e correção Na maioria dos casos que chegam no suporte, a falha tem 4 origens possíveis, e identificá-la leva menos de 5 minutos. A tabela abaixo cruza o sintoma exato da tela com a causa raiz técnica e a primeira ação a tomar. Antes de mudar qualquer coisa, abra o console do navegador (F12, aba Rede) e observe a chamada para `/wp-json/wp/v2/posts`.
Falha de atualização no WordPress: sintomas, causas e correções
Sintoma na tela Causa raiz provável Primeira ação corretiva
Atualização falhou REST API bloqueada por plugin ou firewall Testar com plugins de segurança desativados
A resposta não é um JSON válido HTML injetado antes do JSON por aviso de PHP Ativar WP_DEBUG e ler o aviso
Falha ao publicar, mas o post salvou Timeout da requisição por servidor lento Elevar o max_execution_time do PHP
Erro 403 na chamada /wp-json/ mod_security do servidor barrando o POST Pedir exceção no log do Apache
Use essa leitura como mapa: cada linha leva a um dos passos adiante. O segredo é nunca aplicar a correção do passo 4 quando o sintoma é do passo 2. --- ## O que causa a falha na atualização do WordPress A causa número um, de longe a mais comum nos chamados, é a quebra de comunicação entre o Gutenberg e a WordPress REST API. O editor de blocos salva cada post via uma requisição HTTP para a rota [`/wp-json/`](https://full.services/glossario/rest-api-wordpress/); se algo intercepta essa chamada, o navegador nunca recebe o [JSON](https://full.services/glossario/json-wordpress/) esperado e o WordPress exibe "atualização falhou". Não é defeito do seu conteúdo. Quatro agentes costumam interceptar a rota. Plugins de segurança como o Wordfence ou o All in One Security podem barrar métodos POST por regra de firewall. O próprio servidor, com mod_security ativo, devolve 403 antes de o WordPress responder. Um plugin desatualizado injeta um aviso de [PHP](https://full.services/glossario/php-wordpress/) que polui o JSON. E um CDN como o Cloudflare, com cache agressivo na rota da API, serve uma resposta antiga. Identificar qual deles agiu é o que separa um conserto de 5 minutos de uma tarde perdida tentando adivinhar a origem do erro. --- ## Como corrigir a falha de atualização do WordPress: O passo a passo completo O procedimento abaixo resolve a grande maioria dos casos em ordem de probabilidade, do mais comum ao mais raro, e leva de 5 a 20 minutos. Cada passo isola uma camada: você só avança para o próximo se o erro persistir. Antes de começar, faça um [backup automático do site](https://full.services/backup-wordpress-automatico/), porque alguns passos mexem em plugins ativos. Siga a sequência e você vai resolver a falha sem chutar. ### Passo 1: Verifique a saúde da REST API no site health Abra Ferramentas e clique em Saúde do site: a aba Status roda um teste automático da REST API e sinaliza em vermelho se a rota estiver inacessível. Esse painel nativo, presente desde a versão 5.2 do WordPress, é o ponto de partida porque confirma em 30 segundos se o problema está na API. Se ele acusar "A REST API encontrou um resultado inesperado", você já sabe que a causa não é o seu texto. ### Passo 2: Desative os plugins de segurança, um a um Plugins de firewall respondem por quase metade dos casos de bloqueio da rota `/wp-json/`. Desative o Wordfence, o All in One Security ou similar e tente publicar de novo. Se funcionar, o culpado é ele: reative e adicione a rota da REST API à lista de exceções do firewall, em vez de deixar o plugin desligado. Nunca remova a camada de segurança inteira só para destravar o editor. ### Passo 3: Eleve o limite de memória e tempo do PHP Quando o post é grande ou o tema FSE é pesado, o limite padrão de 128M de memória do PHP 8.2 estoura no meio do salvamento e a requisição morre sem aviso. Edite o arquivo `wp-config.php` por [SFTP](https://full.services/glossario/sftp/) e adicione `define('WP_MEMORY_LIMIT', '256M');`. No painel da hospedagem, suba também o `max_execution_time` para 120 segundos. Esse ajuste resolve as falhas por timeout. ### Passo 4: Cheque o servidor e o CDN Se nada acima resolveu, o bloqueio está fora do WordPress: o mod_security do servidor ou o cache do Cloudflare na rota da API. Peça ao suporte da hospedagem o log de erro do Apache no momento da falha; um 403 ali confirma o firewall do servidor. No [plugin de cache](https://full.services/glossario/plugin-de-cache/) e no CDN, exclua `/wp-json/` de qualquer regra de cache. Essa camada é a mais traiçoeira porque a aba Saúde do site passa mesmo assim. --- ## Quando a falha vira "a resposta não é um JSON válido" Esse erro específico, comum entre as falhas de publicação, é um primo da falha de atualização, mas com causa distinta: algo imprimiu HTML antes do JSON da REST API. Quase sempre é um aviso de PHP de um plugin mal escrito, um espaço em branco no início do `functions.php`, ou um redirecionamento de SSL mal configurado. A lógica do diagnóstico muda aqui. Ative o `WP_DEBUG` no `wp-config.php`, reproduza o erro e leia a primeira linha de aviso: ela aponta o arquivo e a linha do plugin culpado. Na maior parte desses casos no suporte da FULL, o vilão é um snippet antigo no `functions.php` do tema. Tratamos isso a fundo no guia [resolver o erro "não é um JSON válido"](https://full.services/resolver-o-erro-no-wordpress-nao-e-um-json-valido/), que cobre o passo a passo do `WP_DEBUG`. Resolver a origem do HTML extra elimina o erro de vez. --- ## Acelere o diagnóstico com o ecossistema certo Resolver a falha de publicação fica muito mais rápido quando o site já roda os plugins certos e bem configurados, sem conflito entre firewall, cache e editor. A gente vê no suporte que o tempo médio de resolução despenca quando o cliente para de empilhar plugins gratuitos que brigam entre si pela mesma rota da API. A origem de boa parte desses conflitos é justamente o acúmulo de plugins de cache e segurança gratuitos, cada um com sua própria regra sobre a rota `/wp-json/`. No plano PRO da FULL, por R$849, você ativa o pacote completo de plugins premium já afinados entre si, o que dá cerca de R$85 por site quando você gerencia vários projetos ao mesmo tempo. Em vez de testar dez combinações instáveis, você parte de uma stack que já nasce sem briga interna. Conheça os [planos da FULL](https://full.services/planos) e centralize de uma vez as ferramentas que sustentam o seu WordPress. --- ## Como prevenir novas falhas de publicação Três hábitos cortam em mais da metade a chance de o erro voltar, segundo o que observamos na base de tickets. O primeiro é manter o WordPress, o tema e os plugins atualizados de forma ordenada, nunca todos de uma vez; o guia [como atualizar corretamente os plugins do WordPress](https://full.services/como-atualizar-corretamente-os-plugins-do-wordpress/) detalha a sequência segura. Atualização em lote sem teste é a origem de boa parte das falhas. O segundo hábito é ter um backup automático e testado, com UpdraftPlus ou similar, para que qualquer atualização com erro tenha rota de volta; se algo der errado, você sabe [como restaurar o WordPress a partir do backup](https://full.services/como-restaurar-o-wordpress-a-partir-do-backup/) em minutos. O terceiro é isolar a camada de segurança: mantenha a rota `/wp-json/` na lista de exceções do firewall e do CDN. Esses três pontos previnem a reincidência que mais frustra quem já enfrentou uma falha de atualização no WordPress.

Legenda: o aviso de atualização falhou surge quando o Gutenberg não recebe resposta da REST API, e não por erro no conteúdo.

--- --- --- ## Perguntas frequentes sobre falha de atualização no WordPress
Por que a atualização do WordPress falha mesmo com o post correto?

Porque o erro não está no conteúdo, e sim na comunicação entre o editor de blocos e a REST API. O Gutenberg salva cada post via uma chamada HTTP para a rota /wp-json/; quando um plugin de segurança, o mod_security do servidor ou o cache de um CDN intercepta essa requisição, o navegador nunca recebe o JSON de confirmação e o WordPress exibe "atualização falhou". O texto pode estar perfeito que o erro persiste até a rota ser liberada.

É possível corrigir o erro de publicação sem mexer no código?

Sim, na maioria dos casos sem tocar em uma linha de código. Comece pela aba Saúde do site, depois desative os plugins de segurança um a um e teste publicar; só isso resolve cerca de metade dos chamados. Ajustes de PHP no wp-config e exclusão da rota /wp-json/ do cache cobrem o restante. Mexer em código só entra no cenário do "não é um JSON válido", quando um snippet do functions.php precisa ser removido.

Qual a diferença entre falha na publicação e o erro "não é um JSON válido"?

A falha na publicação significa que a requisição para a REST API foi bloqueada ou expirou: o servidor nunca respondeu. Já "a resposta não é um JSON válido" significa que o servidor respondeu, mas sujou a resposta com HTML antes do JSON, geralmente um aviso de PHP. A correção muda: no primeiro caso você libera a rota; no segundo, ativa o WP_DEBUG e remove o código que imprime o HTML extra.

Quanto tempo leva para diagnosticar uma falha na REST API?

Entre 5 e 20 minutos na maioria dos casos, seguindo a ordem de probabilidade. A aba Saúde do site dá o primeiro veredicto em 30 segundos. Desativar os plugins de segurança e testar leva de 2 a 5 minutos. Ajustes de PHP e CDN somam mais 10 minutos. O cenário mais lento é o mod_security do servidor, que exige o log do Apache, mas mesmo ele raramente passa de 20 minutos com o suporte da hospedagem.

O que fazer quando o WordPress diz que a atualização falhou mas o post foi salvo?

Esse sintoma indica timeout: a requisição chegou ao servidor e gravou o post, mas demorou demais para responder e o navegador desistiu antes da confirmação. A correção é elevar o max_execution_time para 120 segundos e o WP_MEMORY_LIMIT para 256M no wp-config. Se persistir, o gargalo é a hospedagem lenta, e não o WordPress; nesse ponto vale avaliar um plano com mais recursos de servidor.

--- ## Próximos passos para um WordPress sem falhas de publicação Resolver a falha de atualização deixa de ser um susto quando você trata a causa, e não o sintoma: na esmagadora maioria das vezes a REST API foi barrada por um plugin, um firewall ou um CDN, nunca pelo seu conteúdo. Siga a tabela de diagnóstico, percorra os seis passos em ordem de probabilidade e separe o cenário de timeout do cenário "não é um JSON válido". Com a rota /wp-json/ liberada nas exceções certas e um backup testado no lugar, a falha some e não volta. Para aprofundar em casos vizinhos, como o [erro 502 Bad Gateway no WordPress](https://full.services/como-corrigir-um-erro-502-bad-gateway-no-wordpress/), e seguir uma trilha guiada de manutenção, vale conhecer o [FULL Academy](https://full.services/academy/), que reúne tutoriais, guias e reviews em um só lugar. --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "TechArticle", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#article", "headline": "Corrigir atualizacao WordPress erro: Guia em 6 passos", "description": "A mensagem "atualização falhou" ou "falha ao publicar" aparece quando o editor de blocos do WordPress não consegue falar com a REST API do site.", "url": "https://full.services/corrigir-atualizacao-wordpress-erro/", "datePublished": "2026-06-26T09:00:00-03:00", "dateModified": "2026-06-26T09:00:00-03:00", "inLanguage": "pt-BR", "articleSection": "Erros WordPress", "keywords": [ "corrigir atualizacao wordpress erro", "WordPress Troubleshooting", "WordPress Errors", "WordPress Support" ], "author": { "@id": "https://full.services/#person-clayton" }, "publisher": { "@id": "https://full.services/#org" }, "about": [ { "@type": "Thing", "name": "WordPress Troubleshooting" }, { "@type": "Thing", "name": "WordPress Errors" }, { "@type": "Thing", "name": "WordPress Support" } ], "mentions": [ { "@type": "Organization", "name": "WordPress", "url": "https://wordpress.org/", "@id": "https://www.wikidata.org/wiki/Q13166", "sameAs": "https://www.wikidata.org/wiki/Q13166" } ], "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/" }, "wordCount": 2297, "citation": [ { "@type": "CreativeWork", "name": "WordPress Developer Docs", "url": "https://developer.wordpress.org/rest-api/", "publisher": { "@type": "Organization", "name": "WordPress Developer Docs" } } ] }, { "@type": "FAQPage", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#faq", "isPartOf": { "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#article" }, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#faq-q1", "name": "Por que a atualização do WordPress falha mesmo com o post correto?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque o erro não está no conteúdo, e sim na comunicação entre o editor de blocos e a REST API. O Gutenberg salva cada post via uma chamada HTTP para a rota /wp-json/; quando um plugin de segurança, o mod_security do servidor ou o cache de um CDN intercepta essa requisição, o navegador nunca recebe o JSON de confirmação e o WordPress exibe "atualização falhou". O texto pode estar perfeito que o erro persiste até a rota ser liberada.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#faq-q2", "name": "É possível corrigir o erro de publicação sem mexer no código?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim, na maioria dos casos sem tocar em uma linha de código. Comece pela aba Saúde do site, depois desative os plugins de segurança um a um e teste publicar; só isso resolve cerca de metade dos chamados. Ajustes de PHP no wp-config e exclusão da rota /wp-json/ do cache cobrem o restante. Mexer em código só entra no cenário do "não é um JSON válido", quando um snippet do functions.php precisa ser removido.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#faq-q3", "name": "Qual a diferença entre falha na publicação e o erro "não é um JSON válido"?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "A falha na publicação significa que a requisição para a REST API foi bloqueada ou expirou: o servidor nunca respondeu. Já "a resposta não é um JSON válido" significa que o servidor respondeu, mas sujou a resposta com HTML antes do JSON, geralmente um aviso de PHP. A correção muda: no primeiro caso você libera a rota; no segundo, ativa o WP_DEBUG e remove o código que imprime o HTML extra.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#faq-q4", "name": "Quanto tempo leva para diagnosticar uma falha na REST API?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Entre 5 e 20 minutos na maioria dos casos, seguindo a ordem de probabilidade. A aba Saúde do site dá o primeiro veredicto em 30 segundos. Desativar os plugins de segurança e testar leva de 2 a 5 minutos. Ajustes de PHP e CDN somam mais 10 minutos. O cenário mais lento é o mod_security do servidor, que exige o log do Apache, mas mesmo ele raramente passa de 20 minutos com o suporte da hospedagem.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#faq-q5", "name": "O que fazer quando o WordPress diz que a atualização falhou mas o post foi salvo?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Esse sintoma indica timeout: a requisição chegou ao servidor e gravou o post, mas demorou demais para responder e o navegador desistiu antes da confirmação. A correção é elevar o max_execution_time para 120 segundos e o WP_MEMORY_LIMIT para 256M no wp-config. Se persistir, o gargalo é a hospedagem lenta, e não o WordPress; nesse ponto vale avaliar um plano com mais recursos de servidor.", "author": { "@id": "https://full.services/#org" } } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://full.services/" }, { "@type": "ListItem", "position": 2, "name": "Erros WordPress", "item": "https://full.services/erros-wordpress/" }, { "@type": "ListItem", "position": 3, "name": "Corrigir atualizacao WordPress erro: Guia em 6 passos", "item": "https://full.services/corrigir-atualizacao-wordpress-erro/" } ] }, { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services", "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "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 (https://thewpweekly.com/awards-2023/)", "Gold Medal - The WP Weekly Awards 2024 (https://thewpweekly.com/awards-2024/)" ], "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. Certificação 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": "Person", "@id": "https://full.services/#person-clayton", "name": "Clayton Margiotti", "givenName": "Clayton", "familyName": "Margiotti", "jobTitle": "Fundador e CEO da FULL Services", "description": "Fundador e CEO da FULL Services, plataforma WordPress SaaS com 50 mil clientes e 150 mil sites conectados, e anchor do ecossistema Elevor Global. Em 2024 conduziu a FULL a se tornar a primeira e unica empresa brasileira aprovada como CVE Numbering Authority sob a CISA (DHS/EUA). Mais de 20 anos construindo empresas digitais, com 13+ reconhecimentos internacionais (Facebook, GPTW, ONU, RD Summit).", "url": "https://full.services/sobre-nos/", "image": "https://full.services/wp-content/uploads/2026/05/clayton-margiotti.jpg", "sameAs": [ "https://www.linkedin.com/in/cmargiotti/" ], "knowsAbout": [ "Artificial Intelligence", "Cybersecurity", "CVE Program", "WordPress Enterprise", "SaaS Platforms", "Digital Infrastructure", "Technology Entrepreneurship", "Company Building", "Business Leadership", "Digital Growth" ], "hasOccupation": { "@type": "Occupation", "name": "Fundador e CEO", "occupationalCategory": "11-1011.00" }, "knowsLanguage": [ { "@type": "Language", "name": "Portuguese", "alternateName": "pt-BR" }, { "@type": "Language", "name": "English", "alternateName": "en" } ], "memberOf": { "@type": "Organization", "name": "CVE Numbering Authorities", "url": "https://www.cve.org/", "sameAs": "https://www.cve.org/" }, "alumniOf": [ { "@type": "EducationalOrganization", "name": "Global Scaling Academy (Blitzscaling Program)", "url": "https://www.blitzscalingacademy.com" }, { "@type": "EducationalOrganization", "name": "Esade", "url": "https://www.esade.edu" }, { "@type": "EducationalOrganization", "name": "Business School Sao Paulo (BSP)", "url": "https://bsp.edu.br/" }, { "@type": "EducationalOrganization", "name": "Tera", "url": "https://somostera.com" }, { "@type": "EducationalOrganization", "name": "Le Wagon", "url": "https://www.lewagon.com" }, { "@type": "EducationalOrganization", "name": "FIAP", "url": "https://www.fiap.com.br" }, { "@type": "EducationalOrganization", "name": "PUCRS", "url": "https://online.pucrs.br/" } ], "award": [ "Digital Disruptor – Engaging Experiences Master (Globant, 2021)", "Maior ROI do e-commerce brasileiro – Letrissimas (Facebook, 2019)", "1º lugar – Melhores Empresas para Trabalhar no Brasil – Eleva Digital (Great Place to Work, 2018)", "Case global de educacao no Facebook – Metodo SUPERA (Facebook, 2017)", "Maquina de Geracao de Leads, Agencia do Ano (RD Summit / RD Station, 2015)", "Monthly Recurring Revenue, top performance (RD Summit / RD Station, 2015)", "Quality/Efficiency – Entrepreneurship Training (UNCTAD / PNUD-ONU, 2010)" ], "subjectOf": [ { "@type": "NewsArticle", "url": "https://www.globant.com/news/globant-reveals-inaugural-digital-disruptors-award-winners", "publisher": { "@type": "Organization", "name": "Globant" } }, { "@type": "NewsArticle", "url": "https://www.prnewswire.com/news-releases/letrissimas-com-e-destaque-do-e-commerce-brasileiro-com-maior-roi-de-2018-877517801.html", "publisher": { "@type": "Organization", "name": "PR Newswire" } }, { "@type": "NewsArticle", "url": "https://www.segs.com.br/seguros/102599-gestao-de-pessoas-garante-mais-lucro-as-empresas", "publisher": { "@type": "Organization", "name": "Segs" } }, { "@type": "NewsArticle", "url": "https://franquiaeducacional.com/negocios-inovadores-facebook-elege-supera-case-mundial-de-educacao", "publisher": { "@type": "Organization", "name": "Franquia Educacional" } }, { "@type": "NewsArticle", "url": "https://acontecendoaqui.com.br/marketing/resultados-digitais-divulga-vencedores-do-premio-agencias-de-resultados-2015-durante-o-rd", "publisher": { "@type": "Organization", "name": "Acontecendo Aqui" } } ], "worksFor": { "@type": "Organization", "@id": "https://full.services/#org" } }, { "@type": "HowTo", "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#howto", "isPartOf": { "@id": "https://full.services/corrigir-atualizacao-wordpress-erro/#article" }, "name": "Passo a passo: corrigir atualizacao wordpress erro", "description": "Guia passo a passo sobre corrigir atualizacao wordpress erro para WordPress.", "url": "https://full.services/corrigir-atualizacao-wordpress-erro/", "totalTime": "PT24M", "author": { "@type": "Organization", "@id": "https://full.services/#org" }, "step": [ { "@type": "HowToStep", "position": 1, "name": "Passo 1: Verifique a saúde da REST API no site health", "text": "Abra Ferramentas e clique em Saúde do site: a aba Status roda um teste automático da REST API e sinaliza em vermelho se a rota estiver inacessível. Esse painel nativo, presente desde a versão 5.2 do WordPress, é o ponto de partida porque confirma em 30 segundos se o problema está na API. Se ele acusar "A REST API encontrou um resultado inesperado", você já sabe que a causa não é o seu texto." }, { "@type": "HowToStep", "position": 2, "name": "Passo 2: Desative os plugins de segurança, um a um", "text": "Plugins de firewall respondem por quase metade dos casos de bloqueio da rota `/wp-json/`. Desative o Wordfence, o All in One Security ou similar e tente publicar de novo. Se funcionar, o culpado é ele: reative e adicione a rota da REST API à lista de exceções do firewall, em vez de deixar o plugin desligado. Nunca remova a camada de segurança inteira só para destravar o editor." }, { "@type": "HowToStep", "position": 3, "name": "Passo 3: Eleve o limite de memória e tempo do PHP", "text": "Quando o post é grande ou o tema FSE é pesado, o limite padrão de 128M de memória do PHP 8.2 estoura no meio do salvamento e a requisição morre sem aviso. Edite o arquivo `wp-config.php` por SFTP e adicione `define('WP_MEMORY_LIMIT', '256M');`. No painel da hospedagem, suba também o `max_execution_time` para 120 segundos. Esse ajuste resolve as falhas por timeout." }, { "@type": "HowToStep", "position": 4, "name": "Passo 4: Cheque o servidor e o CDN", "text": "Se nada acima resolveu, o bloqueio está fora do WordPress: o mod_security do servidor ou o cache do Cloudflare na rota da API. Peça ao suporte da hospedagem o log de erro do Apache no momento da falha; um 403 ali confirma o firewall do servidor. No plugin de cache e no CDN, exclua `/wp-json/` de qualquer regra de cache. Essa camada é a mais traiçoeira porque a aba Saúde do site passa mesmo assim. --- Esse erro específico, comum entre as falhas de publicação, é um primo da falha de atualização, mas com causa distinta: algo imprimiu HTML antes do JSON da REST API. Quase sempre é um aviso de PHP de um plugin mal escrito, um espaço em branco no início do `functions.php`, ou um redirecionamento de SSL mal configurado. A lógica do diagnóstico muda aqui. Ative o `WP_DEBUG` no `wp-config.php`, reproduza o erro e leia a primeira linha de aviso: ela aponta o arquivo e a linha do plugin culpado. Na maior parte desses casos no suporte da FULL, o vilão é um snippet antigo no `functions.php` do tema. Tratamos isso a fundo no guia resolver o erro "não" } ] } ] } ```