Como corrigir a Tela Branca da Morte (WSoD)
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.
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
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.
// 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 esgotadaPerguntas frequentes
Por que a tela branca não mostra nenhuma mensagem de erro?
O wp-admin abre mas o site fica branco (ou o contrário). Por quê?
Como aumento a memória se nem o wp-admin abre?
Renomeei a pasta de plugins e o site voltou. E agora?
A tela branca pode ser causada pelo tema?
Preciso de FTP para resolver a tela branca?
Como corrigir mídia que não faz upload no WordPress
Quando o upload de mídia no WordPress falha, a imagem ou arquivo não chega à Biblioteca de Mídia. As causas mais comuns são permissões erradas na pasta wp-content/uploads, o limite de tamanho de upload do servidor abaixo do arquivo enviado, ou memória PHP insuficiente para processar a imagem.
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.
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.
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.
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.
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.
