Tela branca no WordPress (WSoD): como corrigir

Tipo Erro interno do WP

Nome do erro Como corrigir a Tela Branca da Morte (WSoD)

Severidade Crítico

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

O que é a tela branca no WordPress?

A tela branca no WordPress (White Screen of Death) acontece quando um erro fatal de PHP interrompe a execução antes de qualquer conteúdo ser enviado ao navegador, e a exibição de erros está desligada. O resultado é uma página em branco. Pode atingir o site todo, só o wp-admin ou apenas algumas páginas, dependendo de onde o código falha.

Como identificar

Página completamente branca, sem texto nem código de erro, no front-end ou no wp-admin.
O erro surge logo após ativar/atualizar um plugin ou tema.
Parte do site abre e outra parte fica branca (ex.: home ok, admin branco).
Com WP_DEBUG ligado aparece um “Fatal error” apontando um arquivo e uma linha.

Antes de começar: Faça backup do wp-config.php antes de editá-lo e mantenha WP_DEBUG_DISPLAY como false em produção, para o erro ir só para o log e não aparecer para os visitantes.

Como prevenir

Atualize plugins e temas em ambiente de teste antes de aplicar em produção
Mantenha a versão do PHP suportada e o WP_MEMORY_LIMIT adequado ao site
Tenha backup automático para reverter na hora se uma atualização quebrar

Erros relacionados

Causa

Plugin ou tema com erro fatal de PHP (incompatível com a versão atual do PHP)
Memória PHP esgotada (limite WP_MEMORY_LIMIT baixo demais para o site)
Conflito entre dois plugins que sobrescrevem a mesma função
Arquivo do núcleo corrompido em uma atualização interrompida
Exibição de erros desligada no servidor, escondendo o erro fatal real

Como resolver

Ligue o modo de depuração: edite o wp-config.php para ver o erro fatal escondido, que aponta o arquivo culpado:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```
Desative os plugins: via FTP, renomeie a pasta wp-content/plugins para plugins_off. Se o site voltar, reative um a um até achar o culpado.
Troque para um tema padrão: via FTP, renomeie a pasta do tema ativo. O WordPress cai no tema padrão (Twenty Twenty-*); se voltar, o problema é o tema.
Aumente a memória PHP: adicione o limite maior no wp-config.php, antes da linha 'That's all':
```
define('WP_MEMORY_LIMIT', '256M');
```
Leia o debug.log: abra wp-content/debug.log: a última linha de 'Fatal error' diz exatamente qual arquivo e função quebraram.

PHP

// wp-config.php — diagnostico do WSoD (coloque ANTES de "That's all, stop editing!")
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );      // grava em wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // nao mostra o erro para o visitante
define( 'WP_MEMORY_LIMIT', '256M' ); // resolve WSoD por memoria esgotada

Perguntas frequentes

Por que a tela branca não mostra nenhuma mensagem de erro?

Porque em produção a exibição de erros do PHP fica desligada por segurança. O erro fatal existe, mas não aparece. Ligar o WP_DEBUG revela a mensagem que estava escondida.

O wp-admin abre mas o site fica branco (ou o contrário). Por quê?

Indica que o erro está em algo que carrega só em um contexto: um plugin/tema do front-end, ou um plugin que só roda no admin. Desative-os para isolar qual é.

Como aumento a memória se nem o wp-admin abre?

Edite o wp-config.php via FTP e adicione define('WP_MEMORY_LIMIT', '256M'); antes da linha 'That's all'. Não precisa do painel para isso.

Renomeei a pasta de plugins e o site voltou. E agora?

O culpado é um plugin. Volte o nome da pasta e reative um por um, recarregando o site a cada ativação, até a tela branca voltar e identificar qual é.

A tela branca pode ser causada pelo tema?

Sim. Um erro de PHP no functions.php do tema ativo gera a tela branca. Renomeie a pasta do tema via FTP: o WordPress cai no tema padrão e, se o site voltar, o problema é o tema.

Preciso de FTP para resolver a tela branca?

Quase sempre sim, porque o wp-admin também fica branco. Com FTP você edita o wp-config.php (ligar debug e subir a memória) e renomeia pastas de plugin/tema para isolar a causa.

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 Grave

Como corrigir atualização automática do WordPress que falha

A atualização automática falha quando o WordPress não consegue concluir sozinho a atualização de núcleo, plugins ou temas. As causas mais comuns são permissões de arquivo que bloqueiam a escrita, o WP-Cron que não dispara e a falta de acesso direto ao sistema de arquivos do servidor.

Pro Atenção

Como corrigir Missing a temporary folder

Missing a temporary folder aparece quando o PHP não encontra a pasta temporária onde guarda os arquivos durante um upload. Sem esse diretório, ou sem permissão de escrita nele, o WordPress não consegue receber imagens, plugins ou temas e devolve esse erro.

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.

Grave

Como sair do modo de manutenção travado

O modo de manutenção travado acontece quando uma atualização de plugin, tema ou núcleo é interrompida no meio e o WordPress não chega a remover o arquivo .maintenance da raiz do site. Com esse arquivo presente, o site mostra a mensagem de manutenção a todos os visitantes até que o arquivo seja apagado manualmente.

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.

Setores

Extensões

Integrações

Como corrigir a Tela Branca da Morte (WSoD)

O que é a tela branca no WordPress?

Como identificar

Como prevenir

Erros relacionados

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir The link you followed has expired

Como corrigir atualização automática do WordPress que falha

Como corrigir Missing a temporary folder

Como corrigir Publishing failed / Updating failed (REST API)

Como sair do modo de manutenção travado

Como corrigir o loop Update WordPress Database

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