Como debugar White Screen of Death no WordPress Print

Como debugar o White Screen of Death no WordPress – Guia para Iniciantes (Sensei da GeHost)

Olá, querido cliente! 👋 Se você está lendo isso, provavelmente acabou de abrir seu site no WordPress e se deparou com uma tela branca — nada de conteúdo, nada de erro visível. Isso é o famoso White Screen of Death (WSOD), e pode parecer assustador. Mas calma! É mais comum do que você imagina, e temos um caminho claro para resolver isso juntos. Vou te guiar passo a passo, como um bom Sensei. 🧘‍♂️

Dica do Sensei: O WSOD geralmente acontece por conflito de plugins, temas corrompidos, erro de código ou limite de memória. Vamos investigar com calma!

Passo 1: Verifique se o problema é no seu navegador

Antes de pular para o código, certifique-se de que o problema não é só no seu navegador. Às vezes, cache ou extensões podem causar esse efeito.

• Abra o site em um navegador diferente (como Firefox, Chrome ou Safari).
• Limpe o cache do navegador (Ctrl+Shift+Del ou Cmd+Shift+Del).
• Tente acessar o site em modo anônimo (navegação privada).

Se o site ainda aparece em branco, o problema está no servidor ou no WordPress. Vamos seguir.

Passo 2: Ative o modo de depuração do WordPress

O WordPress pode nos mostrar o erro exato se ativarmos o modo de depuração. Isso é como ligar uma lanterna no escuro.

Para isso, precisamos acessar o arquivo wp-config.php no seu site. Vamos usar o Gerenciador de Arquivos do cPanel.

1. Entre no cPanel usando suas credenciais.
2. Na seção Arquivos, clique em Gerenciador de Arquivos.
3. Selecione a pasta public_html (ou a pasta do seu site, se estiver em subdomínio).
4. Procure o arquivo chamado wp-config.php. Ele está na raiz do site.
5. Clique em Editar (ícone de lápis).

Depois de abrir o arquivo, procure a linha que diz:

define('WP_DEBUG', false);

Altere para:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Salve as alterações.

Dica do Sensei: Sempre faça um backup do arquivo antes de editar! Você pode usar o botão "Fazer cópia" no Gerenciador de Arquivos.

Passo 3: Acesse o site novamente e veja o erro

Volte para o seu site e atualize a página. Agora, em vez de uma tela branca, você deve ver um erro claro no console — algo como:

PHP Fatal error: Uncaught Error: Call to undefined function...

Esse erro é o mapa do problema. Ele nos diz exatamente qual arquivo ou função está falhando.

Passo 4: Identifique o culpado (plugin ou tema)

Se o erro aparecer ao carregar um plugin específico, ele é o culpado. Se o erro for relacionado a arquivos do tema (como functions.php ou header.php), o problema está no tema.

Para testar:

1. Volte ao Gerenciador de Arquivos e vá até a pasta wp-content/plugins.
2. Renomeie a pasta de um plugin (ex: nome-do-plugin → nome-do-plugin-disabled).
3. Atualize o site. Se o erro sumir, o plugin que você desativou era o problema.
4. Repeta o processo com os outros plugins, um por vez.

Se o erro for no tema:

1. Entre em wp-content/themes.
2. Rename o tema atual (ex: meu-tema → meu-tema-backup).
3. O WordPress automaticamente ativa o tema padrão (Twenty Twenty-Four).
4. Se o site voltar a funcionar, o problema está no seu tema.

Passo 5: Aumente a memória do WordPress (solução rápida)

Às vezes, o WSOD acontece por falta de memória. O WordPress pode precisar de mais espaço.

Volte ao arquivo wp-config.php e adicione esta linha antes da linha que diz /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');

Salve e atualize o site. Se o erro parar, o problema era o limite de memória.

Passo 6: Reinstale o WordPress (último recurso)

Se nada funcionar, pode ser que o core do WordPress esteja corrompido. Vamos reinstalar:

1. Entre no cPanel.
2. Use o Gerenciador de Arquivos para acessar public_html.
3. Faça backup de wp-content (temas, plugins, uploads).
4. Exclua todos os arquivos do WordPress exceto wp-content e .htaccess.
5. Download da versão mais recente do WordPress em wordpress.org.
6. Extraia e suba os arquivos para public_html.
7. Restaure os arquivos de wp-content (plugins, temas, uploads).
8. Atualize o site.

Dica do Sensei: Se o site ainda não funciona, entre em contato com nosso suporte. Estamos aqui para te ajudar com um abraço virtual! 🤗

Conclusão: Você está no caminho certo!

WSOD pode parecer um monstro, mas com paciência e um passo de cada vez, ele é derrotado. Lembre-se:

• Ative o modo de depuração para ver o erro real.
• Teste plugins e temas um por um.
• Garanta que o WordPress tem memória suficiente.
• Se tudo falhar, reinstale com cuidado.

Se precisar de ajuda, é só chamar o Sensei da GeHost — estamos aqui com você, sempre. 💚