White Screen of Death — Tela branca no WordPress
O que é a Tela Branca da Morte?
A “White Screen of Death” (WSOD), ou Tela Branca da Morte, é um dos problemas mais frustrantes do WordPress. O site exibe apenas uma página completamente em branco — sem mensagem de erro, sem indicação do problema, sem nada. É como se o WordPress simplesmente parasse de existir.
Isso acontece porque o PHP encontrou um erro fatal mas foi configurado para não exibir mensagens de erro (o que é a configuração correta para sites em produção). O resultado é uma página em branco que não dá nenhuma pista sobre o que aconteceu.
Diagnóstico inicial
Verifique se o wp-admin funciona
O primeiro passo é tentar acessar seusite.com/wp-admin. Se o painel funcionar normalmente, o problema está apenas no tema — provavelmente um erro no arquivo functions.php ou em um template. Se o wp-admin também estiver em branco, o problema é mais profundo e afeta o core do WordPress.
Ativando o modo de debug
Para descobrir o erro real, ative o modo de debug no wp-config.php:
// Adicionar ao wp-config.php antes de "That's all, stop editing!"
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('WP_DEBUG_LOG', true);Após salvar e atualizar o site, o erro real será exibido na tela em vez da tela branca. Com essa informação, fica muito mais fácil identificar e corrigir o problema.
Isolando plugins e temas
Desativando todos os plugins
Via FTP, renomeie a pasta wp-content/plugins para wp-content/plugins_off. Isso desativa todos os plugins simultaneamente sem precisar acessar o painel. Se a tela branca desaparecer, um dos plugins é o culpado. Renomeie a pasta de volta e reative os plugins um a um.
Trocando o tema via banco de dados
Se não conseguir acessar o painel para trocar o tema, faça isso diretamente pelo banco de dados no phpMyAdmin. Na tabela wp_options, localize e atualize os registros template e stylesheet:
UPDATE wp_options
SET option_value = 'twentytwentyfour'
WHERE option_name = 'template' OR option_name = 'stylesheet';Aumentando o limite de memória
Uma causa comum da tela branca é o limite de memória PHP esgotado. Adicione ao wp-config.php:
define('WP_MEMORY_LIMIT', '256M');Após resolver o problema
Depois de identificar e corrigir a causa da tela branca, lembre-se de desativar o modo de debug alterando para define('WP_DEBUG', false);. Exibir erros PHP em produção é um risco de segurança pois pode revelar informações sensíveis sobre a estrutura do seu site.
Causa
A tela branca da morte (WSOD) ocorre quando o PHP encontra um erro fatal mas não consegue exibir nenhuma mensagem — o resultado é uma página completamente em branco. Isso geralmente acontece por conflito entre plugins, tema com erro de PHP, limite de memória esgotado ou atualização do WordPress que introduziu incompatibilidade. O problema é especialmente frustrante porque não fornece nenhuma pista visual do que deu errado, exigindo diagnóstico via logs ou modo de debug.
Como resolver
Tente acessar o painel wp-admin. Se funcionar, o problema é só no frontend.
Ative o debug pelo wp-config.php para ver o erro:
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);define('WP_MEMORY_LIMIT', '256M');Troque para tema padrão do WordPress acessando o banco de dados no phpMyAdmin:
UPDATE wp_options SET option_value = 'twentytwentyfour' WHERE option_name = 'template';
UPDATE wp_options SET option_value = 'twentytwentyfour' WHERE option_name = 'stylesheet';define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('WP_MEMORY_LIMIT', '256M');Erro: Allowed memory size exhausted — Memória esgotada
Fatal error: Allowed memory size of X bytes exhausted. Ocorre quando o PHP tenta alocar mais memória do que o limite configurado.
sanitize_text_field() — Sanitizar entradas do usuário
Remove tags HTML, codificação extra e caracteres problemáticos de uma string antes de armazená-la no banco de dados.
Hook rest_api_init — Registrar rotas na REST API
Permite registrar endpoints customizados na WordPress REST API com suporte a autenticação, validação de parâmetros e callbacks de permissão.
wp_remote_get() — Requisições HTTP externas
Realiza uma requisição HTTP GET para uma URL externa de forma assíncrona e segura usando a WordPress HTTP API.
Hook init — Registros e inicialização de recursos
O hook init é disparado após o WordPress ter carregado mas antes de enviar qualquer header. Ideal para registrar CPTs, taxonomias e rewrite rules.
Parse error: syntax error — Erro de sintaxe no WordPress
Erro de sintaxe PHP que impede o carregamento do site. Ocorre quando um comando não é escrito corretamente no código.