# 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.

## 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

- [Como corrigir Publishing failed / Updating failed (REST API)](https://full.services/wp-fixer/corrigir-publishing-failed-rest-api-wordpress/)
- [Como identificar conflito de plugins no WordPress](https://full.services/wp-fixer/identificar-conflito-de-plugins-wordpress/)
- [Como corrigir a Tela Branca da Morte (WSoD)](https://full.services/wp-fixer/corrigir-tela-branca-da-morte-wordpress/)

## 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

1. 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.
2. 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.
3. 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.
4. 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.
5. 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.

## Código

```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.

**Fonte:** [Block Editor Handbook — developer.wordpress.org](https://developer.wordpress.org/block-editor/)