Diagnóstico de resposta JSON inválida ao salvar no editor do WordPress

Resposta JSON inválida no WordPress: como diagnosticar a falha ao publicar

Ao clicar em Publicar, Atualizar ou Salvar rascunho, o editor de blocos mostrou “A publicação falhou. A resposta não é uma resposta JSON válida” — ou uma mensagem semelhante? Não repita o clique imediatamente. Copie o conteúdo ainda visível para um local privado, verifique se o post já foi salvo e só então investigue a requisição que falhou. O aviso não identifica sozinho o culpado nem prova que o conteúdo não foi gravado.

Este tutorial trata do erro de resposta JSON inválida no WordPress durante o salvamento no editor. Se o site inteiro estiver fora do ar ou apresentar HTTP 500 e “houve um erro crítico”, use o guia de erro crítico no WordPress. Se todos os posts públicos dão 404, investigue esse problema de alcance geral separadamente. Para conhecer a interface antes do diagnóstico, veja como funciona o editor Gutenberg do WordPress.

Antes de testar: preserve o post e isole o ambiente

Confira Posts → Todos os posts — ou a lista correspondente a páginas e outros tipos de conteúdo —, incluindo status, horário de modificação e eventuais duplicatas. Reabra o item apenas depois de guardar o texto que ainda está no editor; evite editar simultaneamente em outra aba. Uma falha ao receber a resposta pode ocorrer depois de o servidor ter processado a operação. Se houver dúvida sobre o estado publicado, pare e confirme com o responsável antes de tentar de novo.

Para reproduzir o erro, prefira um rascunho de teste não publicado em um staging WordPress protegido que represente a versão, os plugins e as camadas de rede do site. Isole envios de e-mail, webhooks, pedidos e notificações reais. A análise inicial da aba Rede é observacional; antes de mudar plugins, cache, URLs, HTTPS, WAF ou regras de servidor, prepare backup restaurável de arquivos e banco, responsável e plano de reversão. Não restaure banco antigo sobre pedidos ou usuários novos.

1. Localize a requisição de salvamento na aba Rede

  1. Com permissão para editar o rascunho de teste, abra as ferramentas do navegador e a aba Rede/Network antes de salvar. Se necessário, filtre por Fetch/XHR ou wp-json. Os nomes das abas variam por navegador.
  2. Faça uma tentativa de salvar o rascunho. Identifique a requisição iniciada naquele momento. Anote internamente o método, caminho da URL sem parâmetros sensíveis, status HTTP, tipo de corpo recebido e, se houver, origem e destino dos redirecionamentos. No Chrome, as abas Headers e Response ajudam a conferir isso; consulte a referência do painel Network. Se o navegador ocultar a cadeia de redirecionamentos, a opção de preservar o registro durante a navegação pode ajudar.
  3. Volte à lista de posts e confira o estado persistido. Não reenvie o conteúdo só porque a interface mostrou erro.

Em uma instalação comum, a atualização de um post pode usar POST /wp-json/wp/v2/posts/<id>, documentado na referência da REST API de posts. A rota efetiva deve ser observada no navegador: páginas, criação de posts, mídia e tipos personalizados podem usar outras rotas. Abrir /wp-json/ em uma aba testa, no máximo, o acesso à raiz pública da API; não comprova que a requisição autenticada de edição funciona. O uso de cookies e nonce na REST API também depende das permissões da conta, conforme a documentação de autenticação do WordPress.

Privacidade: não compartilhe HAR, “Copy as cURL”, corpo da requisição ou resposta, cookies, Authorization, X-WP-Nonce, URL com token, texto do rascunho ou logs brutos. Com o suporte autorizado, use apenas horário, método, rota saneada, status, tipo de resposta e eventual ID de bloqueio sem dados pessoais.

2. O que o status e a resposta sugerem?

O que apareceu na requisição de salvamento Pista, não causa comprovada Próxima checagem segura
200/201, mas corpo HTML, aviso PHP ou página de login Resposta inesperada do aplicativo ou alterada em alguma camada Conferir quem respondeu, comparar com staging e correlacionar os logs.
301/302, ou URL final em outro domínio, esquema ou tela de login Redirecionamento, sessão ou configuração de URL/proxy Comparar URL inicial e final sem alterar nada ainda.
401/403 com JSON de erro válido Falha de autenticação, nonce, permissão ou política de acesso Conferir sessão, capacidades e mensagem de erro em ambiente seguro; JSON válido não é, por si, JSON inválido.
403 com página HTML de bloqueio Uma camada de segurança pode ter interceptado a chamada Solicitar ao provedor correlação do evento pelo horário e rota.
404 apenas na rota de salvamento Rota, reescrita, subdiretório ou bloqueio específico Comparar outras rotas e a configuração do servidor.
500/502/503, timeout ou corpo vazio Erro do aplicativo, servidor intermediário ou indisponibilidade Relacionar horário e rota com logs e verificar se outras páginas falham.

Um código HTTP isolado não fecha diagnóstico. Um 403 pode trazer JSON perfeitamente válido, e uma página HTML pode chegar com 200. Se a requisição observada devolveu JSON esperado e o editor ainda reclama, verifique se outra requisição falhou e peça ao responsável que examine erros de JavaScript; não atribua a falha à primeira chamada vista.

3. Investigue URL, HTTPS e permalinks somente quando houver indício

Há mudança de domínio ou protocolo?

Compare o endereço do wp-admin, a URL inicial da requisição e a URL final. Se tiver acesso, confira Configurações → Geral → Endereço do WordPress (URL) e Endereço do site (URL), sem editar: eles podem legitimamente ser diferentes. Registre diferenças entre http e https, www e sem www, subdiretórios e desvios para login. Em instalações com proxy/CDN, o WordPress documenta loops de redirecionamento relacionados ao reconhecimento do HTTPS. Mudar URL, certificado, constantes em wp-config.php ou regra de redirect sem plano pode interromper o login. A tag canonical de SEO do post não é a URL-base da REST API.

A rota de salvamento responde 404?

Veja Ferramentas → Diagnóstico do site (quando disponível) e confira se existem avisos relevantes; um teste saudável não garante que toda rota privada de escrita esteja funcionando. Em Configurações → Links permanentes, compare a estrutura atual e teste se o 404 também ocorre em posts públicos. A documentação oficial da tela de permalinks diz que visitar a tela já aciona a atualização das regras de reescrita; não é preciso clicar em Salvar apenas para isso. Essa ação, contudo, não conserta toda falha de roteamento ou configuração externa. Não troque a estrutura pública para “Simples” por tentativa. Se houver indício de problema de servidor, envolva quem administra Apache, Nginx ou proxy, com backup e rollback antes de alterar regras.

4. Isole WAF, plugin ou erro do servidor com evidência

Se recebeu HTML de bloqueio, peça à hospedagem ou ao responsável pelo WAF/CDN que compare horário, rota saneada e identificador do evento. Só após confirmar falso positivo avalie uma exceção mínima e documentada. Não desative WAF, autenticação ou proteção REST globalmente em produção.

Se o problema surgiu após atualização ou a resposta contém avisos PHP, reproduza no staging representativo e altere um componente de cada vez. O modo de troubleshooting do Health Check isola plugins e tema na sessão do usuário, mas não torna seguro publicar conteúdo real em produção nem reproduz necessariamente todas as camadas externas. Plugin de cache, editor ou segurança é hipótese até uma comparação controlada confirmar.

Para HTTP 500, resposta incompleta ou aviso PHP, peça correlação dos logs no mesmo horário. Nosso guia de log de erros no WordPress explica a coleta segura; habilitar debug ou editar wp-config.php requer backup, acesso controlado e cuidado para não exibir erros ou dados sensíveis ao público. Se há falha generalizada, retorne à triagem do site como um todo.

5. Confirme o resultado sem arriscar o conteúdo

Depois de identificar uma causa com evidência, teste uma mudança autorizada em staging, com backup e caminho de reversão. Salve o mesmo rascunho de teste e confira a resposta da requisição, o status na lista, o conteúdo persistido ao reabrir, a ausência de redirects inesperados e o funcionamento de login e edição. Verifique também fluxos públicos afetados pela mudança, sem gerar transações reais. Só então planeje a mudança pontual em produção com monitoramento.

Pare e peça ajuda se não tiver acesso à requisição que falhou, se o staging não reproduz as camadas relevantes ou se a correção envolver URLs, regras de servidor ou segurança sem responsável técnico. A mensagem “resposta não é JSON válido” descreve um sintoma: a investigação começa pela resposta da requisição específica, não por desativar proteções às cegas.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *