Como usar o modo de depuração (debug) do WordPress para encontrar a origem de um erro

Como usar o modo de depuração (debug) do WordPress para encontrar a origem de um erro

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

Se você está lendo este guia, provavelmente está enfrentando um erro no seu site WordPress — talvez uma tela branca, um aviso de erro ou um comportamento estranho. Não se preocupe: isso é mais comum do que parece, e hoje vamos te ensinar a usar o modo de depuração (debug) do WordPress para descobrir exatamente o que está errado. É como ter um “detector de falhas” no seu site!

Como seu Sensei da GeHost, vou te guiar passo a passo com calma, clareza e um toque de carinho. Vamos lá?

Antes de começar: o que é o modo de depuração?

O modo de depuração é uma ferramenta que permite ao WordPress mostrar mensagens de erro detalhadas — como "Erro na linha 142 do arquivo functions.php" — em vez de apenas uma tela branca ou uma mensagem genérica.

É como se o seu site dissesse:

"Ah, eu não estou funcionando porque o arquivo X está com um problema no trecho Y. Me ajuda a consertar?"

⚠️ Importante: Ative o debug apenas em ambientes de teste ou em sites em desenvolvimento. Nunca deixe o debug ativado em um site público — ele pode mostrar informações sensíveis para os visitantes.

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

1. Acesse o Gerenciador de Arquivos do cPanel

   Entre no seu painel de controle (cPanel) com suas credenciais. Na tela principal, localize e clique em Gerenciador de Arquivos.

   

2. Localize a pasta do seu site

   Na árvore de pastas, clique em public_html (ou o nome da sua pasta principal, se diferente). É aqui que está instalado o WordPress.

   

3. Abra o arquivo wp-config.php

   Procure pelo arquivo chamado wp-config.php na pasta public_html. Clique nele com o botão direito e escolha a opção Editar.

   Este é o arquivo principal de configuração do WordPress. Ele contém dados importantes como banco de dados, senhas e, agora, a chave para ativar o debug.

4. Encontre a linha que diz: define('WP_DEBUG', false);

   Use o atalho Ctrl + F (ou Cmd + F no Mac) para procurar por WP_DEBUG no código.

   Se estiver escrito define('WP_DEBUG', false);, é isso que precisamos mudar!

5. Ative o debug

   Altere a linha para:

   define('WP_DEBUG', true);

   Isso ativa o modo de depuração. Agora, o WordPress vai começar a mostrar erros detalhados.

6. Adicione configurações extras (opcional, mas recomendado)

   Para melhorar o diagnóstico, adicione estas linhas logo abaixo da linha do WP_DEBUG:

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

   Isso faz com que os erros sejam salvos em um arquivo chamado debug.log (no diretório do WordPress), sem aparecer na tela do visitante — mais seguro!

7. Salve as alterações

   Após editar o arquivo, clique em Salvar (ou Salvar Arquivo) no topo do editor.

8. Teste o erro novamente

   Volte ao seu site e tente reproduzir o erro (por exemplo, acessar uma página que dá erro, fazer login no painel, etc.).

   Se tudo estiver funcionando, nada aparecerá na tela — mas o erro será gravado no arquivo debug.log.

9. Verifique o arquivo debug.log

   No Gerenciador de Arquivos, volte ao diretório do WordPress (public_html) e procure por um arquivo chamado debug.log.

   Abra o arquivo e leia as mensagens. Elas mostrarão exatamente onde está o problema: qual arquivo, qual linha, qual tipo de erro (aviso, erro fatal, etc.).

   Exemplo de mensagem:

   PHP Fatal error: Uncaught Error: Call to undefined function my_custom_function() in /public_html/wp-content/themes/meutema/functions.php on line 45

   Pronto! Agora você sabe que o erro está na função my_custom_function() no arquivo functions.php da sua temática.

Como desativar o debug depois de resolver

Depois de encontrar e corrigir o problema:

• Volte ao arquivo wp-config.php.
• 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, limpo e funcionando como deveria.

Dica do Sensei: sempre faça backup antes de alterar arquivos

Antes de editar qualquer arquivo do WordPress (como wp-config.php), faça um backup da sua conta. Isso garante que, mesmo que algo dê errado, você possa voltar ao ponto anterior.

No cPanel, vá em Backup → Backup Completo e clique em Gerar Backup. Seu site estará salvo em segurança.

Conclusão: você está no controle!

Usar o modo de depuração pode parecer assustador no começo, mas agora você sabe que é só uma ferramenta poderosa para entender o que está acontecendo por trás das cenas do seu site.

Se mesmo assim tiver dúvidas ou não conseguir resolver, é só nos chamar. Estamos aqui para te ajudar — com paciência, calor e um bom café (virtual, claro 😉).

Com carinho,
Seu Sensei da GeHost 🌿