Erro de tela branca (WSOD) no WordPress: como identificar e corrigir

Erro de Tela Branca (WSOD) no WordPress: Como Identificar e Corrigir

Olá, querido(a) cliente da GeHost! 👋

Se você está lendo este guia, é provável que seu site WordPress esteja mostrando uma tela completamente branca — sem erros, sem mensagens, só branco. Isso é comum, mas não precisa assustar. Na verdade, é um sinal claro de que algo está acontecendo em segundo plano, e nós vamos resolver juntos, passo a passo. Você não está sozinho(a) — eu sou seu Sensei da GeHost, e estou aqui para te guiar com calma, paciência e cuidado.

Antes de tudo: isso não é um problema do servidor da GeHost. É algo que pode acontecer por causa de erros no código do seu site, plugins, temas ou configurações. Vamos descobrir o que está causando e consertar com segurança.

Passo 1: Verifique se o problema é no seu site ou no navegador

Antes de entrar em pânico, confirme se o erro está mesmo no seu site:

• Abra seu site em outro navegador (ex: Chrome, Firefox, Safari).
• Use um dispositivo diferente (celular, tablet).
• Tente acessar o site em modo anônimo (navegação privada).

Se o problema persistir em todos os navegadores e dispositivos, então o erro está no seu site — e podemos seguir com as soluções.

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

Este é o nosso "olho mágico" para ver o que está errado. Vamos ativar o modo de depuração para ver mensagens de erro.

1. Entre no cPanel da sua hospedagem: painel.gehost.com.br.
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 subpasta).
4. Localize o arquivo chamado wp-config.php.
5. Clique com o botão direito no arquivo e escolha Editar.
6. Procure pela linha que diz:

define('WP_DEBUG', false);

7. Altere para:

define('WP_DEBUG', true);

8. Salve as alterações.

Depois de salvar, acesse seu site novamente. Agora, se houver algum erro, ele aparecerá na tela — como um aviso de "Fatal error", "Call to undefined function", ou algo assim. Isso nos dá pistas valiosas.

Passo 3: Verifique o arquivo de erro mais comum

Se o erro aparecer, ele provavelmente está ligado a um dos arquivos abaixo:

• wp-config.php — Verifique se há erros de sintaxe (ex: colchetes ou parênteses mal fechados).
• functions.php — Se você modificou o tema, talvez tenha um erro no código.
• plugins — Um plugin pode estar causando o conflito.

Se o erro for sobre um plugin, vamos desativá-lo temporariamente.

Passo 4: Desative plugins e temas (modo seguro)

Quando o WordPress não consegue carregar, podemos usar o modo seguro para desativar tudo.

1. No Gerenciador de Arquivos, vá até a pasta wp-content.
2. Renomeie a pasta plugins para plugins.bak.
3. Renomeie a pasta themes para themes.bak.
4. Salve as alterações.

Volte a acessar seu site. Se ele carregar agora, o problema estava em um plugin ou no tema.

Para descobrir qual é o culpado:

• Recoloque a pasta themes.bak para themes (para voltar ao tema original).
• Recoloque a pasta plugins.bak para plugins — mas agora, desative um por um, testando o site após cada desativação.

Quando o site voltar a funcionar, o último plugin ativado é o culpado. Desative-o permanentemente ou entre em contato com o suporte do plugin.

Passo 5: Reinstale o WordPress (se necessário)

Se nada funcionar, talvez o core do WordPress esteja corrompido. Neste caso, podemos reinstalar o WordPress sem perder seus dados.

1. No cPanel, vá até Backup > Backup Completo.
2. Crie um backup da sua conta (para segurança).
3. Entre na pasta public_html e faça o download de todos os arquivos do seu site (salve em seu computador).
4. Apague todos os arquivos dentro de public_html (exceto .htaccess, index.html, robots.txt).
5. Volte ao WordPress.org e baixe a versão mais recente do WordPress.
6. Extraia os arquivos e coloque no public_html.
7. Reinstale seu tema e plugins (os que você salvou).

Seu site deve voltar a funcionar. Se ainda não funcionar, pode ser um problema de banco de dados — e aí, pedimos ajuda ao nosso suporte.

Passo 6: Peça ajuda ao suporte da GeHost

Se você tentou tudo e o erro persiste, não se preocupe — é hora de chamar o time de especialistas da GeHost.

Entre em contato via:

• Painel do cliente: painel.gehost.com.br
• Formulário de suporte (dentro do painel)
• Envie uma mensagem com:
• Seu domínio (ex: seu-site.com)
• Descrição do erro (ex: "tela branca após atualização do plugin X")
• Se já tentou ativar o modo de depuração (e o que apareceu)
• Se já fez backup

Seu suporte é composto por profissionais que trabalham com amor, cuidado e dedicação — e estão prontos para te ajudar. Eles podem acessar o servidor com segurança para investigar, sem precisar de senhas suas.

Como prevenir o erro no futuro

• Atualize sempre o WordPress, temas e plugins.
• Use apenas plugins e temas de fontes confiáveis.
• Faça backups regulares (use o Backup Completo no cPanel).
• Evite editar arquivos do WordPress sem saber o que está fazendo.

Resumo do que você aprendeu hoje

Erro de tela branca (WSOD) no WordPress pode parecer assustador, mas é solucionável com paciência e passos claros:

• Verifique se o erro é no navegador ou no site.
• Ative o modo de depuração para ver o erro real.
• Desative plugins e temas temporariamente.
• Reinstale o WordPress se necessário.
• Peça ajuda ao suporte da GeHost — eles estão aqui para você.

Lembre-se: você não está sozinho. A GeHost é seu parceiro de confiança desde 2015, com o coração no trabalho