Gutenberg não carrega: como corrigir o editor de blocos

Tipo Erro interno do WP

Nome do erro Como corrigir o editor de blocos (Gutenberg) que não carrega

Severidade Grave

Descrição 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.

O que é o Gutenberg que não carrega?

O Gutenberg não carregar significa que o editor de blocos do WordPress não termina de montar a interface: a tela de edição fica em branco, presa na animação de carregamento, ou o WordPress recua para o Editor Clássico. O editor de blocos é uma aplicação JavaScript (React) carregada no wp-admin; qualquer erro de script no meio do carregamento trava toda a interface, mesmo que o conteúdo do post esteja intacto no banco.

Como identificar

A área de edição abre completamente em branco, sem a barra de blocos.
Mensagem “This block has encountered an error and cannot be previewed.” no lugar do conteúdo.
O editor fica preso na animação de carregamento e nunca exibe o post.
No console do navegador (F12) aparece “Uncaught TypeError” ou erro de script wp-block-editor.

Antes de começar: Antes de reinstalar o núcleo ou mexer no tema via FTP, faça backup completo do site. Reinstalar a versão atual não apaga conteúdo, mas substitui arquivos do core, então um backup garante a reversão se algo sair errado.

Como prevenir

Exclua os scripts do wp-admin da minificação/combinação de JS no plugin de cache desde o início
Atualize núcleo, tema e plugins em ambiente de teste antes de aplicar em produção
Acompanhe o console do navegador após instalar plugins que adicionam blocos personalizados

Erros relacionados

Causa

Plugin de cache ou de otimização minificando/combinando o JavaScript do editor (wp-block-editor, wp-element)
Conflito de plugin que enfileira uma versão antiga de jQuery ou um script com erro no wp-admin
Tema com erro de JavaScript no functions.php interferindo na carga do editor
Arquivos de núcleo desatualizados após uma atualização interrompida (scripts do editor incompatíveis)
Bloqueio da REST API em /wp-json/, da qual o editor depende para carregar o conteúdo do post

Como resolver

Abra o console do navegador: pressione F12 e veja a aba Console. A primeira linha em vermelho aponta qual script falhou, que é o caminho mais rápido para a causa.
Limpe o cache e a minificação: no plugin de cache, limpe tudo e exclua os scripts do wp-admin da minificação/combinação de JS. Teste em uma aba anônima para descartar cache do navegador.
Desative os plugins: via FTP, renomeie a pasta wp-content/plugins para plugins_off. Se o editor voltar, reative um a um até achar o que injeta o erro de JavaScript.
Troque para um tema padrão: via FTP, renomeie a pasta do tema ativo. O WordPress cai num tema Twenty Twenty-*; se o editor carregar, o problema está no JavaScript do seu tema.
Reinstale o núcleo: em Painel > Atualizações, clique em Reinstalar a versão atual. Isso restaura os arquivos de script do editor que ficaram corrompidos.

PHP

// functions.php do tema-filho — desativa a minificacao do editor em conflito
// Use so para diagnostico: confirma se o JS combinado e a causa do editor nao carregar.
add_action( 'enqueue_block_editor_assets', function () {
    // Garante o jQuery do core no editor, evitando versao antiga injetada por plugin
    wp_deregister_script( 'jquery' );
    wp_register_script( 'jquery', includes_url( '/js/jquery/jquery.min.js' ), array(), null, false );
    wp_enqueue_script( 'jquery' );
}, 1 );

// Desliga a tentativa de carregar o editor classico forcado por plugins legados
add_filter( 'use_block_editor_for_post', '__return_true', 100 );

Perguntas frequentes

Por que o editor abre em branco mas o site funciona?

Porque o editor de blocos é uma aplicação JavaScript carregada só no wp-admin. Um erro de script trava a interface do editor sem afetar o front-end, que serve HTML já pronto. Por isso o site abre normal e só o editor falha.

Um plugin de cache pode fazer o Gutenberg não carregar?

Sim. A minificação ou combinação de JavaScript pode quebrar os scripts do editor (wp-block-editor, wp-element). Limpe o cache e exclua os arquivos do wp-admin dessas otimizações para testar.

O que significa This block has encountered an error?

É o aviso de que um bloco específico falhou ao renderizar, geralmente por incompatibilidade de versão de um plugin de blocos. Atualize o plugin que fornece esse bloco ou converta o bloco para HTML e reedite.

Como descubro qual plugin está quebrando o editor?

Abra o console do navegador (F12) para ver qual script falha. Em paralelo, desative os plugins via FTP renomeando a pasta wp-content/plugins e reative um a um até o erro voltar e identificar o culpado.

O Gutenberg cai no Editor Clássico sozinho. Por quê?

Isso costuma vir de um plugin legado que força o Editor Clássico, ou de uma falha de carregamento que faz o WordPress recuar para o modo de compatibilidade. Verifique plugins de editor clássico e o console do navegador.

Preciso reinstalar o WordPress para corrigir?

Raramente o WordPress inteiro. Reinstalar a versão atual do núcleo em Painel > Atualizações restaura só os arquivos de script do editor, sem apagar conteúdo. Faça isso apenas depois de descartar cache, plugins e tema.

Pro Grave

Como corrigir permalinks retornando 404

Permalinks retornando 404 é quando só a página inicial abre e todos os posts e páginas internas dão erro 404. Quase sempre as regras de reescrita do WordPress foram perdidas ou o .htaccess ficou sem as linhas que traduzem as URLs amigáveis para o WordPress.

Pro Atenção

Como corrigir The link you followed has expired

O link que você seguiu expirou aparece quase sempre ao subir um tema ou plugin pesado pelo painel, quando o arquivo passa do limite de upload do servidor. O WordPress aborta o envio e devolve a mensagem genérica de link expirado, em vez do erro real de tamanho.

Pro Atenção

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.

Crítico

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.

Atenção

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.

Grave

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.

Setores

Extensões

Integrações

Como corrigir o editor de blocos (Gutenberg) que não carrega

O que é o Gutenberg que não carrega?

Como identificar

Como prevenir

Erros relacionados

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir permalinks retornando 404

Como corrigir The link you followed has expired

Como corrigir Destination folder already exists no WordPress

Como corrigir a Tela Branca da Morte (WSoD)

Como corrigir o loop Update WordPress Database

Como corrigir Publishing failed / Updating failed (REST API)

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos