Como resolver o erro 'Página inicial em branco' (tela branca da morte) no WordPress

Como resolver o erro "Página inicial em branco" no WordPress (tela branca da morte)

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

Se você está vendo uma tela branca ao acessar seu site WordPress — sem erros, sem mensagem, só branco — não se preocupe. Esse problema, conhecido como "Tela Branca da Morte", é comum, mas geralmente tem solução simples. Vamos juntos, passo a passo, como consertar isso com calma e segurança.

Antes de começar, lembre-se: você está no guia da GeHost — sua casa de hospedagem, com suporte e ferramentas prontas para te ajudar. Vamos lá!

🔍 Primeiro: entenda o que está acontecendo

Uma tela branca no WordPress geralmente ocorre por um erro no código — como um plugin, tema ou arquivo de configuração com um problema. O WordPress não consegue carregar a página porque encontrou um erro de sintaxe ou de memória.

É como se o site tivesse um "caminho quebrado" no caminho da entrada. Não é um problema de hospedagem — é um problema de configuração no seu site. Vamos consertar!

🛠️ Passo a passo: como resolver a tela branca

1. Ative o modo de depuração do WordPress

Esse é o passo mais importante. Ele vai mostrar exatamente qual arquivo ou linha está causando o erro.

Para isso, vamos acessar o arquivo wp-config.php no seu site. Ele está dentro da pasta principal do WordPress (geralmente public_html).

Para acessar, use o Gerenciador de Arquivos do cPanel:


2. Localize o arquivo wp-config.php

Na pasta public_html, procure por um arquivo chamado wp-config.php. Clique nele com o botão direito e escolha Editar.

3. Adicione as linhas de depuração

Procure pela linha que diz:

define('WP_DEBUG', false);

Substitua por:

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

Isso vai ativar o modo de depuração, salvar os erros em um arquivo e não mostrar os erros diretamente na tela (evitando mais brancos).

4. Salve as alterações

Clique em Salvar ou Salvar e Fechar no editor.

5. Recarregue o site

Volte para o site e recarregue a página. Agora, em vez de ficar em branco, você verá o erro real — como "Fatal error: Uncaught Error: Call to undefined function..." ou "Parse error: syntax error".

6. Identifique o problema

Com o erro visível, você saberá qual arquivo ou plugin está causando o problema. Geralmente, é:

• Um plugin mal instalado ou atualizado.
• Um tema com código corrompido.
• Um arquivo de configuração com erro de sintaxe.
7. Desative plugins e temas

Se o erro aparecer após atualizar algo, o mais seguro é desativar tudo e ir ativando um por um.

Para isso, renomeie a pasta dos plugins:

• Na pasta wp-content, encontre a pasta plugins.
• Renomeie-a para plugins_backup (ou qualquer nome diferente).

Depois, acesse o site novamente. Se funcionar, o problema era um plugin. Agora, renomeie de volta e vá ativando um por um para encontrar o culpado.

8. Verifique o tema

Se o problema persistir, o tema pode estar corrompido. Renomeie a pasta do tema atual dentro de wp-content/themes para algo como tema_atual_backup.

Depois, o WordPress vai voltar ao tema padrão (como Twenty Twenty-Four). Se o site voltar a funcionar, o problema é no seu tema.

9. Restaure arquivos originais

Se você fez alterações no código do WordPress, tema ou plugin, pode ter colocado um erro de sintaxe. Baixe uma cópia limpa do WordPress (do site oficial: wordpress.org/download) e substitua os arquivos corrompidos.

10. Desative o modo de depuração

Quando o site estiver funcionando normalmente, volte ao arquivo wp-config.php e troque novamente:

define('WP_DEBUG', false);

Isso é importante para segurança — não deixe o modo de depuração ativado em produção.

💡 Dicas importantes (como um verdadeiro Sensei)

• Se você não sabe como editar arquivos, use o suporte da GeHost. Nós estamos aqui para te ajudar — basta entrar no Painel do Cliente e abrir um chamado.
• Nunca edite arquivos diretamente se não souber o que está fazendo. Erros podem piorar o problema.
• Antes de atualizar plugins ou temas, faça um backup completo da sua conta. Você pode usar a ferramenta Backup no cPanel.
• Se o erro persistir mesmo após tudo isso, pode ser um problema de memória. O WordPress precisa de pelo menos 64MB, mas recomendamos 256MB. Isso pode ser ajustado no arquivo wp-config.php com:

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

📬 Precisa de ajuda? Estamos aqui!

Se você chegou até aqui e ainda não resolveu, não se preocupe. A GeHost é feita para te ajudar. Basta entrar no Painel do Cliente, abrir um chamado e contar o que aconteceu. Nós te ajudamos com carinho, como um verdadeiro Sensei.

Se precisar, envie o erro exato que apareceu (copie e cole) e vamos resolver juntos.

Com carinho,
Seu Sensei da GeHost 🌿