Como exibir mensagens de erro detalhadas no WordPress (modo desenvolvimento)
Oi, tudo bem? Aqui é a Sensei da GeHost! 🥋 Se você está desenvolvendo ou ajustando um site WordPress e precisa entender exatamente onde um erro está acontecendo, este guia vai te ensinar a ativar o "modo debug" do WordPress — que faz ele mostrar mensagens de erro detalhadas em vez da famosa tela branca sem explicação nenhuma.
Atenção antes de começar: esse recurso é só para o momento de desenvolvimento/ajuste. Deixar mensagens de erro visíveis num site que já está no ar, recebendo visitantes, pode expor detalhes técnicos do seu site. No final deste guia te mostro como desligar tudo direitinho quando terminar.
O que é o WP_DEBUG?
O WordPress tem um "modo silencioso" ligado por padrão: quando algo dá errado (um plugin com conflito, um tema com erro de código etc.), ele geralmente esconde a mensagem técnica do visitante. Isso é ótimo para o público, mas péssimo para quem está desenvolvendo, porque você fica sem pista nenhuma do que aconteceu. Ativando o WP_DEBUG, o WordPress passa a te mostrar (ou registrar num arquivo) os avisos, erros e alertas que ele encontra — isso acelera MUITO a hora de descobrir "por que essa página não carrega".
Passo 1 — Acesse o Gerenciador de Arquivos
Primeiro, entre no seu cPanel (o painel de controle da sua hospedagem) e abra o Gerenciador de Arquivos.
- Dentro do Gerenciador de Arquivos, entre na pasta public_html (ou na subpasta onde seu WordPress está instalado, caso ele não esteja na raiz).
- Procure o arquivo chamado wp-config.php. Ele fica sempre na pasta principal da instalação do WordPress.
Dica da Sensei: antes de editar qualquer coisa, clique com o botão direito no wp-config.php e escolha "Baixar" (download) para guardar uma cópia no seu computador. Assim, se algo sair diferente do esperado, você consegue voltar rapidinho ao original.
Passo 2 — Edite o arquivo wp-config.php
Clique com o botão direito no arquivo wp-config.php e escolha a opção Editar (ou "Code Editor"). Vai abrir uma tela de edição de texto.
Procure a linha que diz:
define( 'WP_DEBUG', false );
Ela costuma estar perto do trecho onde diz "That's all, stop editing! Happy publishing." — ou seja, um pouco acima dele.
Passo 3 — Substitua pelo bloco de debug completo
Troque aquela linha (ou adicione, se ela não existir) pelo seguinte bloco, sempre antes da linha que diz "stop editing":
- define( 'WP_DEBUG', true ); — liga o modo debug.
- define( 'WP_DEBUG_LOG', true ); — grava todos os erros num arquivo de registro (debug.log), dentro da pasta wp-content, para você consultar com calma depois.
- define( 'WP_DEBUG_DISPLAY', false ); — impede que os erros apareçam na tela para qualquer visitante; eles ficam só registrados no arquivo de log, protegendo seu site enquanto você investiga.
Por que WP_DEBUG_DISPLAY como false? Assim você consegue ver os erros com segurança, abrindo o arquivo de log quando quiser, sem deixar informação técnica exposta na tela para qualquer pessoa que visite o site nesse meio-tempo. É o jeito mais seguro de debugar.
Passo 4 — Salve e consulte o arquivo de log
- Clique em Salvar Alterações no editor.
- Volte no Gerenciador de Arquivos e entre na pasta wp-content. Depois de reproduzir o erro no site (recarregando a página com problema), vai aparecer um arquivo chamado debug.log ali dentro.
- Abra esse arquivo (clique em Editar ou "Visualizar") para ler as mensagens — elas mostram o nome do arquivo, a linha e o tipo de erro, o que ajuda bastante a identificar a causa.
Passo 5 — MUITO importante: desligue ao terminar
Assim que resolver o problema, volte no wp-config.php e deixe assim novamente:
define( 'WP_DEBUG', false );
Isso evita deixar registros de erro se acumulando à toa e mantém seu site no comportamento padrão de produção.
Se você tem dificuldade em editar esse tipo de arquivo, ou não se sentir à vontade para mexer no código, sem problema! Nossa equipe de suporte pode te ajudar — é só abrir um chamado pelo painel.gehost.com.br. Lembrando que todo serviço entregue pela GeHost já vem com 30 dias de suporte gratuito após a entrega. 💙
Prontinho! Agora você já sabe como fazer o WordPress "falar" com você quando algo dá errado — uma ferramenta e tanto para quem está desenvolvendo ou ajustando um site. Qualquer dúvida, a Sensei está por aqui! 🥋