Como colocar o WordPress em modo de depuração (debug) para identificar a origem de um erro

Como colocar o WordPress em modo de depuração para identificar erros (GUIA PARA CLIENTES LEIGOS)

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

Se você está com um erro no seu site WordPress — como uma tela branca, mensagem de erro estranha ou algo que simplesmente não funciona direito — o modo de depuração pode ser o seu melhor amigo para descobrir o que está acontecendo por trás das cenas.

Não se preocupe: não é necessário ser um técnico. Vou te guiar passo a passo, com carinho e clareza, como ativar esse modo no seu site WordPress, direto do painel da GeHost. Vamos lá?

O que é o modo de depuração?

Imagine que seu site é um carro. Quando ele para de funcionar, você não quer apenas saber que "não roda" — quer saber por que. O modo de depuração é como ligar um "modo diagnóstico" no carro: ele mostra mensagens detalhadas de erro, como se fosse um relatório de falhas.

Isso ajuda a identificar exatamente onde está o problema: um plugin mal instalado, um arquivo corrompido, um erro no código…

Importante: o modo de depuração só deve ser usado temporariamente durante a resolução de erros. Ele pode mostrar informações sensíveis (como caminhos de arquivos ou credenciais) — por isso, desative assim que o erro for resolvido.

Passo a passo: Ative o modo de depuração no WordPress

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

1. Entre no painel da GeHost: Acesse painel.gehost.com.br com suas credenciais.
2. Abra o Gerenciador de Arquivos: No painel, clique em Arquivos e depois em Gerenciador de Arquivos.

3. Localize a pasta do seu site: Na lista de pastas, clique em public_html (ou o nome da sua pasta raiz, se estiver em subpasta).
4. Encontre o arquivo wp-config.php: Ele está na raiz da pasta. Clique duas vezes nele para abri-lo.
5. Procure pela linha que diz: define('WP_DEBUG', false);

6. Altere para:

   define('WP_DEBUG', true);

   Isso ativa o modo de depuração.

7. Adicione estas linhas abaixo:

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

   Essas linhas fazem o seguinte:

   • WP_DEBUG_LOG — salva os erros em um arquivo de log, sem mostrar na tela.
   • WP_DEBUG_DISPLAY — evita que erros sejam exibidos diretamente no site (segurança).
8. Salve as alterações: Clique em Salvar no canto superior direito.
9. Atualize seu site: Acesse seu site no navegador. Se houver erros, eles serão gravados no arquivo wp-content/debug.log.

Como encontrar o arquivo de log

Depois de ativar o modo de depuração, os erros são salvos em um arquivo chamado debug.log. Para encontrá-lo:

1. No Gerenciador de Arquivos, vá até a pasta wp-content.
2. Abra o arquivo debug.log.
3. Leia as mensagens. Elas mostram o tipo de erro, a página onde aconteceu e o arquivo envolvido.

💡 Dica do Sensei: Se o arquivo estiver vazio, o erro pode ter sido causado por um plugin ou tema que não foi carregado. Tente desativar plugins um a um (pelo painel do WordPress) ou trocar temporariamente de tema.

Como desativar o modo de depuração

Assim que o erro for resolvido, volte ao arquivo wp-config.php e faça o seguinte:

• Altere define('WP_DEBUG', true); para define('WP_DEBUG', false);
• Salve o arquivo
• Apague o arquivo debug.log (opcional, mas recomendado para segurança)

Pronto! Seu site está seguro novamente.

Quer ajuda com o log de erros?

Se os erros no debug.log ainda forem difíceis de entender, envie o conteúdo para o nosso suporte. Nós vamos te ajudar a decifrar!

Se precisar de ajuda com o painel, plugins ou temas, estamos aqui — com um sorriso e um coração de cliente da GeHost ❤️

Até a próxima, e lembre-se: todo erro é uma oportunidade de aprender.