Introdução
Ao ter problemas com plug-ins do WordPress, muitas vezes é difícil identificar a causa exata. Os problemas podem resultar de conflitos de plug-ins, incompatibilidades de temas ou problemas de configuração do servidor. O plug-in "Verificação de integridade e solução de problemas", desenvolvido pela equipe do WordPress.org, é uma ferramenta de diagnóstico poderosa que ajuda a isolar e identificar esses problemas.
O que é Verificação de integridade e solução de problemas?
Health Check & Troubleshooting é um plugin oficial do WordPress.org que permite:
- Execute diagnósticos em sua instalação do WordPress
- Entre em um "modo de solução de problemas" que desativa todos os plug-ins e alterna para um tema padrão apenas para sua sessão de usuário
- Reative seletivamente plugins e temas para identificar conflitos
- Reúna informações técnicas sobre seu site para fins de suporte
O principal benefício é que o modo de solução de problemas afeta apenas seu usuário administrador – seus visitantes continuarão a ver seu site normalmente enquanto você diagnostica problemas.
Instalação
- Faça login no painel do WordPress
- Vá para Plugins > Adicionar Novo
- Pesquise por "Verificação de integridade e solução de problemas"
- Clique em "Instalar agora" e depois em "Ativar"
Verificando se há erros de JavaScript no console do navegador
Antes de usar o plug-in de verificação de integridade, geralmente é importante verificar se há erros de JavaScript que possam estar causando problemas de funcionalidade:
- Abra as ferramentas de desenvolvedor do seu navegador:
- Chrome/Edge: Pressione F12 ou clique com o botão direito do mouse e selecione "Inspecionar"
- Firefox: Pressione F12 ou clique com o botão direito do mouse e selecione "Inspecionar elemento"
- Safari: ative as ferramentas de desenvolvedor em Preferências > Avançado e pressione Option+Command+I
- Navegue até a guia "Console"
- Interaja com o recurso problemático (clique em botões, envie formulários, etc.)
- Procure mensagens de erro vermelhas que aparecem no console
- Preste atenção aos nomes de script mencionados nos erros
- Observe todas as referências a plug-ins específicos nos caminhos do arquivo
- Procure padrões como erros "indefinidos" ou "nulos"
- Documente quaisquer erros que você encontrar para compartilhar com as equipes de suporte
Os erros de JavaScript geralmente podem identificar imediatamente qual plug-in está causando um problema ou fornecer pistas valiosas sobre a natureza de um conflito.
Usando o modo de solução de problemas para diagnosticar problemas
Etapa 1: entre no modo de solução de problemas#
- Acesse Ferramentas > Integridade do Site
- Clique na guia "Solução de problemas"
- Clique no botão "Entrar no modo de solução de problemas"
- O WordPress será recarregado em um estado básico com todos os plugins desativados e usando um tema padrão (apenas para sua sessão)
Etapa 2: testar seu problema#
Uma vez no modo de solução de problemas, teste se o problema que você estava enfrentando ainda ocorre:
- Se o problema for RESOLVIDO (não ocorre mais): Isso confirma que o problema está relacionado a um plug-in ou ao seu tema
- Se o problema persistir: O problema pode estar relacionado aos principais arquivos do WordPress, configuração do servidor ou problemas de banco de dados
Etapa 3: Teste sistemático (se o problema foi resolvido)#
Se o problema foi resolvido no modo de solução de problemas, siga estas etapas para identificar a causa específica:
- Ainda no modo de solução de problemas, clique em "Ativar e testar plug-in" ao lado do seu tema para testar se o tema está causando o problema
- Se o problema retornar, seu tema é a causa
- Se o problema não retornar, continue testando os plug-ins
- Habilite os plug-ins um por um:
- Clique em "Ativar e testar plug-in" ao lado de um plug-in
- Teste se o problema retorna depois que cada plug-in é ativado
- Continue até encontrar o plug-in que faz com que o problema retorne
- Quando você encontrar o plug-in ou tema conflitante:
- Anote isso
- Você pode mantê-lo desativado ou entrar em contato com o desenvolvedor para obter suporte
Etapa 4: sair do modo de solução de problemas#
Depois de identificar o problema:
- Clique em "Desativar modo de solução de problemas" na parte superior da tela
- Seu site retornará ao seu estado normal com todos os plugins e seu tema ativos
O que fazer depois de identificar um conflito
Se o problema for com um plug-in:#
- Verifique se o plugin tem atualizações disponíveis
- Pesquise no fórum de suporte do plug-in por problemas semelhantes
- Entre em contato com o desenvolvedor do plugin com detalhes específicos:
- Versão WordPress
- Versão do PHP
- Outros plug-ins ativos
- Etapas para reproduzir o problema
- Quaisquer mensagens de erro do console do navegador
Se o problema for com um tema:#
- Verifique se as atualizações do tema estão disponíveis
- Considere mudar temporariamente para um tema padrão do WordPress
- Entre em contato com o desenvolvedor do tema com detalhes específicos
Se o problema persistir no modo de solução de problemas:#
Isso sugere questões mais profundas, como:
- Problemas de integridade do arquivo principal do WordPress
- Corrupção de banco de dados
- Problemas de configuração do servidor
- Problemas de compatibilidade de versão do PHP
Nesses casos, considere:
- Executando uma verificação de integridade do site (Ferramentas > Status > de integridade do site)
- Consultando seu provedor de hospedagem
- Buscando ajuda de um desenvolvedor WordPress
Técnicas avançadas de solução de problemas
Usando as informações de depuração da verificação de integridade#
- Acesse Ferramentas > Informações do > de integridade do site
- Esta página contém informações detalhadas sobre a configuração do WordPress
- Clique em "Copiar para a área de transferência" para compartilhar com as equipes de suporte
Testando com contas de usuário alternativas#
Às vezes, os problemas afetam apenas funções de usuário específicas:
- Criar uma conta de usuário temporária com uma função diferente
- Teste se o problema ocorre para esta nova conta de usuário
Verificando os logs de erros do servidor#
Os erros do servidor podem não ser visíveis no navegador:
- Verifique se há logs de erros no painel de controle da sua hospedagem
- Ou adicione
define('WP_DEBUG', true);edefine('WP_DEBUG_LOG', true);ao seu arquivo wp-config.php - Os erros serão registrados em /wp-content/debug.log
Dicas para solução de problemas eficiente
- Método de pesquisa binária : Para sites com muitos plugins, use uma abordagem de "dividir e conquistar":
- Habilite metade dos seus plugins e teste
- Se o problema aparecer, o problema está nessa metade; se não, está na outra metade
- Continue dividindo o grupo problemático ao meio até isolar o problema
- Este método é significativamente mais rápido do que testar plug-ins um por um quando você tem muitos plug-ins
- Conflitos complexos : Esteja ciente de que alguns problemas são causados por combinações de plug-ins:
- Se você não conseguir identificar um único plug-in problemático, tente testar combinações diferentes
- Preste atenção aos plug-ins que atendem a funções semelhantes (vários plug-ins de SEO, várias soluções de cache)
- Às vezes, dois plug-ins funcionam bem individualmente, mas entram em conflito quando usados juntos
- Documentação metódica : Mantenha anotações detalhadas do que você testou e dos resultados
- Mudanças recentes : Comece testando plugins ou temas instalados ou atualizados recentemente
- Culpados comuns : Teste primeiro os plug-ins de alto impacto (cache, segurança, plug-ins de otimização)
- Limpar cache : Certifique-se de limpar todos os plug-ins de cache ao testar
- Teste de navegador : Teste em vários navegadores para descartar problemas específicos do navegador
Quando entrar em contato com o suporte do plug-in
Se você identificou um problema, mas não consegue resolvê-lo sozinho:
- Reúna informações abrangentes :
- Versão WordPress
- Versão do PHP
- Lista completa de plugins ativos
- Nome e versão do tema
- Informações do navegador e do dispositivo
- Etapas exatas para reproduzir o problema
- Capturas de tela ou gravações de tela, se aplicável
- Quaisquer mensagens de erro do console do navegador
- Verifique a documentação existente :
- Revise a base de conhecimento do plug-in
- Pesquise no fórum de suporte do plug-in por problemas semelhantes
- Envie um tíquete de suporte detalhado :
- Inclua todas as informações coletadas acima
- Seja específico sobre o que você já tentou
- Mencione que você usou a Verificação de integridade para isolar o problema
- Forneça acesso temporário de administrador, se possível e apropriado
Quanto mais informações você fornecer em sua solicitação de suporte inicial, mais rápido a equipe de suporte poderá ajudá-lo a resolver o problema.
Finalmente
O plugin Health Check & Troubleshooting é uma ferramenta inestimável para diagnosticar problemas do WordPress sem interromper seu site ativo. Ao testar sistematicamente plugins e temas, você pode identificar conflitos e fornecer informações detalhadas para as equipes de suporte quando necessário.
Lembre-se: sempre faça backup do seu site WordPress antes de fazer alterações significativas em plugins, temas ou arquivos principais.
Recursos#
- Verificação de integridade e solução de problemas no WordPress.org
- WordPress.org Fóruns de suporte
- Como enviar uma solicitação de suporte eficaz
Updated on 16 de abril de 2026 · Need help? Open a support ticket