O seu site está em baixo com um ecrã branco. Um plugin foi atualizado e o painel de administração não carrega. Erro 500, mas os registos estão vazios. Sem as ferramentas certas, depurar o WordPress transforma-se em adivinhação: passa horas a testar plugins aleatoriamente e não consegue encontrar a causa.

Uma boa ferramenta de depuração destaca o problema em segundos. Mostra qual o plugin ou tema que está a causar o conflito, quais os erros de PHP que se estão a acumular em segundo plano e onde está o estrangulamento. Sem essa ferramenta, está às cegas. E uma má ferramenta apenas acrescenta ruído.

Neste resumo, 5 ferramentas para depurar e resolver problemas no WordPress em 2026. Três delas resolvem a tarefa direta: isolar conflitos, registar e escrever automaticamente constantes no wp-config.php. As outras duas cobrem cenários relacionados sem os quais a resolução de problemas é impossível: filtrar spam e proteger contra ataques. Cada uma foi testada em projetos reais.

💡 Visão geral rápida:

• Execute o Health Check para isolar conflitos de plugins e temas sem tempo de inatividade
• Ligue o Akismet para filtragem automática de spam de comentários e formulários de contacto
• Use o Plugin Detective para encontrar o plugin em conflito através de um assistente passo a passo
• Ative o WP Debugging para escrever constantes de depuração no wp-config.php sem um editor de código
• Instale o Solid Security para análise de vulnerabilidades e uma firewall de ponto de entrada

Tabela de comparação de ferramentas:

1. Health Check & Troubleshooting

Plugin oficial da equipa do WordPress.org. A primeira ferramenta a executar em qualquer situação de emergência. A sua principal funcionalidade, o Modo de Resolução de Problemas: ativa o modo de depuração, o plugin desativa TODOS os plugins ativos e muda o tema para um tema padrão. Mas APENAS para si. Os visitantes do site continuam a ver a versão normal. Sem tempo de inatividade.

Depois, volta a ativar os plugins um a um e observa em que momento o erro regressa. O processo de eliminação, automatizado e seguro. Na prática, isto reduz a procura de um plugin em conflito de horas para 10 a 15 minutos.

O separador Estado do Site verifica a configuração do servidor: versão do PHP, limites de memória, presença de módulos necessários, estado do HTTPS. A ferramenta de Integridade verifica as somas de verificação dos ficheiros do WordPress para ver se os ficheiros do sistema foram adulterados. A secção de Informações de Depuração compila um relatório completo sobre a configuração do site, que pode copiar e enviar para um programador ou para o suporte de alojamento.

Vantagens:

• Ferramenta oficial, atualizada juntamente com o núcleo do WordPress
• O Modo de Resolução de Problemas não afeta os visitantes
• Relatório completo da configuração do servidor com um clique
• Verificação da integridade dos ficheiros do sistema

Desvantagens:

• Não mostra erros de PHP em tempo real, apenas confirma a sua presença
• O Modo de Resolução de Problemas funciona de forma menos flexível com temas do que com plugins

Preço: gratuito.

🔗 Health Check & Troubleshooting no WordPress.org

2. Akismet

O Akismet não é um depurador no sentido clássico. Mas quando está à procura da causa dos problemas do site, centenas de comentários de spam na base de dados são ruído que mascara os erros reais. Uma base de dados obstruída torna o wp-admin mais lento. Comentários falsos com links quebrados geram erros 404 nos registos. O Akismet resolve esta tarefa: limpa o spam automaticamente, sem a sua intervenção.

O plugin vem pré-instalado no WordPress e funciona através de uma base de dados global de assinaturas de spam. Quando um comentário chega ao site, o Akismet verifica-o em relação a esta base de dados e filtra instantaneamente o lixo. Apenas vê comentários reais. E erros reais, não obscurecidos pelo spam.

O histórico de estado dos comentários mostra que moderadores aprovaram ou rejeitaram o quê. Integração com Contact Form 7, Gravity Forms e Jetpack de raiz: o filtro de spam funciona não só nos comentários, mas também nos formulários de contacto. A limpeza da base de dados de spam acelera indiretamente o site, menos lixo em wp_comments e wp_commentmeta.

Vantagens:

• Pré-instalado, não requer instalação separada
• Base de dados global de spam atualizada em tempo real
• Filtra spam em formulários de contacto através de integrações
• Poupa espaço na base de dados

Desvantagens:

• Não é uma ferramenta de depuração propriamente dita: protege contra o ruído, mas não procura erros
• Por vezes, sinaliza comentários reais como spam, sendo necessária uma revisão manual da pasta de Spam
• A versão Pro é paga para sites comerciais

Preço: versão Lite gratuita para blogues pessoais; Pro: desde $10/mês (assinatura anual: desde $100/ano, dois meses grátis em comparação com o plano mensal).

🔗 Akismet no WordPress.org🔗 Akismet Pro

3. Plugin Detective

O Plugin Detective resolve uma tarefa, e fá-lo na perfeição: encontra o plugin que está a causar a falha do site. Ao contrário do Health Check, NÃO simula a desativação. Desativa realmente os plugins e faz-lhe perguntas num formato de assistente passo a passo.

Lança o assistente em qualquer página, seja no painel de administração ou no frontend. O plugin desativa grupos de plugins um a um e pergunta: «O erro desapareceu?» Responde «Sim» ou «Não», e o Plugin Detective reduz a lista de suspeitos. Após algumas iterações, aponta para o plugin culpado específico. Nada de código, nada de logs, apenas botões.

Vantagem crítica: funciona mesmo quando só vê um ecrã branco da morte (WSOD). Se o painel de administração estiver inacessível, o Plugin Detective pode ser lançado na mesma, não depende da interface visual do WordPress. E se o site ficar preso no modo de «manutenção breve» após uma atualização falhada, o plugin pode remover o ficheiro de bloqueio .maintenance.

Vantagens:

• Interface de assistente: qualquer utilizador sem conhecimentos técnicos consegue usá-lo
• Funciona durante WSOD e erros fatais
• Desativa realmente os plugins, não simula
• Remove ficheiros .maintenance bloqueados

Desvantagens:

• Não faz depuração de temas, apenas de plugins
• Não mostra erros de PHP nem logs
• Sem versão Pro com funcionalidades alargadas

Preço: gratuito.

🔗 Plugin Detective no WordPress.org

4. WP Debugging

A ferramenta mais direta deste resumo. O WP Debugging faz exatamente o que um programador experiente faria manualmente: escreve as constantes de depuração no wp-config.php. Ative o plugin e as constantes são adicionadas. Desative e são removidas. Sem editor de código, sem FTP, sem o risco de um erro de digitação derrubar o site.

O plugin adiciona a constante WP_DEBUG ao wp-config.php. Juntamente com ela, são ativadas WP_DEBUG_LOG, WP_DEBUG_DISPLAY e SCRIPT_DEBUG. Este é o conjunto completo para registar erros do WordPress. Após a ativação, os erros são escritos em /wp-content/debug.log e pode ler este ficheiro diretamente do painel de administração. Deixa de ser necessário o acesso SSH ao servidor.

Nuance importante: o WP Debugging não mostra erros aos visitantes do site, ao contrário da configuração manual WP_DEBUG_DISPLAY = true. Escreve-os no log, de forma discreta e segura. Quando desativado, o plugin restaura os valores originais das constantes, caso já estivessem definidos no wp-config.php. Sem artefactos.

O plugin também funciona bem com o Query Monitor e o Debug Bar: se estiverem instalados, o WP Debugging integra-se e estende as suas funcionalidades. E o filtro nativo wp_debugging_constants permite personalizar o conjunto de constantes para necessidades específicas do projeto.

Vantagens:

• Escrita e remoção automática das constantes de depuração
• Leitura do debug.log diretamente do painel de administração
• Não mostra erros aos visitantes
• Restaura os valores originais das constantes na desativação
• Integração com o Query Monitor e o Debug Bar

Desvantagens:

• Não encontra plugins em conflito
• Não verifica a integridade dos ficheiros
• Requer uma compreensão básica de erros PHP para interpretar os logs

Preço: gratuito.

🔗 WP Debugging no WordPress.org

5. Solid Security

O Solid Security (anteriormente iThemes Security) cobre um cenário muitas vezes esquecido: o site cai não por causa de um bug no código, mas devido a uma invasão ou ataque. Um bot de DDoS sobrecarrega o servidor com pedidos. Uma vulnerabilidade num plugin permite o upload de código malicioso. Um ataque de força bruta descobre a palavra-passe de administrador. Isto não são erros de PHP. Mas o resultado é o mesmo: o site está em baixo.

O plugin oferece mais de 30 métodos de proteção. O scanner de vulnerabilidades verifica plugins e temas instalados em busca de CVEs conhecidas e alerta-o se alguma versão já não estiver a receber correções. A firewall bloqueia pedidos suspeitos antes de chegarem ao WordPress. A autenticação de dois fatores impede ataques de força bruta às contas de utilizador.

Bloqueio de User Agents maliciosos, proteção contra adivinhação de palavras-passe, monitorização de alterações de ficheiros, tudo isto funciona em segundo plano sem a sua intervenção. Na prática, o Solid Security previne problemas que, de outra forma, teriam de ser "depurados" após o sucedido: limpar ficheiros infetados, restaurar a base de dados, redefinir palavras-passe.

Vantagens:

• Proteção abrangente: firewall, scanner de vulnerabilidades e 2FA num só plugin
• Previne ataques antes que estes derrubem o site
• Scanner de CVEs com alertas sobre plugins desatualizados
• A versão gratuita cobre as necessidades básicas

Desvantagens:

• Não é uma ferramenta de depuração: é proteção, não caça aos bugs
• Versão Pro $80/ano, mais cara do que outros plugins deste resumo
• Exagerado para sites de brochura simples, sem formulários e utilizadores

Preço: versão Lite gratuita; Pro: licença anual $80 (dois sites, atualização para mais, taxa adicional).

🔗 Solid Security no WordPress.org🔗 Solid Security Pro

Técnicas básicas de depuração: logs, constantes, pilha de chamadas, mostradas neste vídeo de 15 minutos do WordPress Developer Resources:

⁉️🤔 Perguntas frequentes

O que fazer se nenhum plugin for identificado como o problema?

Isto acontece quando o problema não está nos plugins, mas no tema ou no próprio núcleo do WordPress. Execute o Modo de Resolução de Problemas no Health Check & Troubleshooting, ele mudará o tema para um padrão (Twenty Twenty-Five em 2026). Se o erro desaparecer, o problema está no seu tema. Se não, reinstale o núcleo do WordPress através de "Atualizações" no painel de administração. Se ainda assim não resolver, verifique os logs do servidor através do painel de alojamento: erros de memória, timeouts, limites de processos.

Porque é que o WP Debugging é melhor do que adicionar manualmente as constantes ao wp-config.php?

Segurança e rapidez. A edição manual do wp-config.php via FTP ou gestor de ficheiros é arriscada devido a erros de digitação: uma aspa ou ponto e vírgula em falta derruba o site. O WP Debugging faz isto de forma automática e limpa. Segunda vantagem, a desativação: o plugin restaura os valores originais das constantes, enquanto que com o método manual pode esquecer-se de remover WP_DEBUG_DISPLAY = true e mostrar erros aos visitantes durante semanas.

Porque está o Akismet num resumo de ferramentas de depuração?

O spam é ruído que mascara problemas reais. Quando a base de dados tem 50.000 comentários de spam, o painel de administração fica lento e o wp-cron sufoca com a limpeza. Os logs enchem-se de erros 404 de links de spam quebrados. O Akismet remove este ruído e você vê os erros reais, não as consequências de um ataque de spam. Não é um depurador, mas sem dados limpos, o diagnóstico é impossível.

Solid Security, um plugin de segurança. Porque está numa lista de depuração?**

Porque, na prática, um terço das "quedas" de sites WordPress estão relacionadas não com bugs de código, mas com invasões: código malicioso no tema, um ataque DDoS ao xmlrpc.php, uma palavra-passe descoberta e uma shell carregada. Depurar isto é inútil, é preciso preveni-lo. O Solid Security fecha esta classe de problemas no ponto de entrada, e a "depuração" resume-se a ler o log de ataques, não a restaurar o site a partir de uma cópia de segurança.

Como escolher entre o Health Check e o Plugin Detective?

Se o site estiver a funcionar e conseguir aceder ao painel de administração, escolha o Health Check. O seu Modo de Resolução de Problemas é mais seguro: simula a desativação, os visitantes não veem alterações. Se o site estiver em baixo com um ecrã branco da morte e o painel de administração estiver inacessível, escolha o Plugin Detective. Ele é iniciado contornando a interface quebrada e desativa realmente os plugins para trazer o site de volta à vida. Idealmente, tenha ambos: eles complementam-se.

O que instalar para depurar o WordPress em 2026

Cada ferramenta neste resumo cobre a sua própria parte do fluxo de trabalho de resolução de problemas. Escolha não "o melhor plugin em geral", mas uma combinação para a sua tarefa.

Se o site caiu agora mesmo e o painel de administração não carrega, inicie o Plugin Detective. Ele trará o site de volta à vida em 5 a 10 minutos, sem código e sem logs. Assim que o painel de administração estiver novamente acessível, ligue o Health Check & Troubleshooting e percorra o Modo de Resolução de Problemas, encontrará a causa exata do conflito.

Para prevenção, mantenha o WP Debugging sempre ativo: ele escreve discretamente os erros no log sem os mostrar aos visitantes. Verifique o debug.log uma vez por semana e verá os problemas ANTES de eles derrubarem o site. Deixe o Akismet limpar o spam, menos ruído na base de dados, painel de administração mais rápido, logs mais limpos. E use o Solid Security para fechar vulnerabilidades no ponto de entrada: scanner de CVEs, firewall, 2FA. Esta é a combinação que usamos nos nossos projetos.

Escreva nos comentários qual a ferramenta que o ajudou a depurar o WordPress, ou coloque uma questão se não souber o que escolher para o seu caso. Subscreva o blogue para não perder os próximos resumos e tutoriais.