Erros do WordPress

Sobre esta categoria de erros

# Erros do WordPress

As falhas do WordPress podem aparecer como uma página em branco, um 500 Internal Server Error, uma mensagem explícita do banco de dados ou um aviso de esgotamento da memória do PHP. Esses sintomas não indicam necessariamente o mesmo problema. Comece registrando exatamente o que os visitantes veem, o que o painel do WordPress informa e o que mudou antes da falha.

Use os guias desta categoria para relacionar o sintoma visível à parte mais provável da stack do WordPress. Uma falha que ocorre imediatamente após a atualização de um plugin exige uma primeira verificação diferente de uma mensagem de conexão com o banco de dados ou de um erro Allowed memory size ... exhausted. Evite alterar vários componentes ao mesmo tempo: testes controlados facilitam a identificação da causa e ajudam a evitar que ela seja reintroduzida.

Padrões comuns de erros do WordPress

Erro 500 após uma atualização de plugin

Um 500 Internal Server Error que começa imediatamente após a atualização de um plugin faz desse plugin o principal suspeito. A atualização pode revelar um problema de compatibilidade com o PHP ou um conflito com o tema ativo, outro plugin ou o ambiente de hospedagem.

A confirmação mais útil é desativar ou reverter o plugin atualizado usando um método de recuperação disponível e, em seguida, testar a requisição afetada. Se o site se recuperar, analise os detalhes do erro do PHP e teste a versão do plugin com a combinação de tema e plugins existente. Não presuma que toda resposta 500 seja causada pelo host.

Consulte [Erro 500 do WordPress após atualizar um plugin](/wordpress-500-error-after-plugin-update) para um diagnóstico específico.

Tela Branca da Morte do WordPress

A Tela Branca da Morte é uma resposta completamente em branco, sem nenhum erro útil exibido. Isso costuma ocorrer quando um erro fatal do PHP é ocultado dos visitantes. A página em branco, por si só, não permite identificar se o problema está em um plugin, tema, operação do PHP, limite de memória ou arquivo danificado do WordPress.

O próximo passo é localizar o erro subjacente por meio da depuração do WordPress ou do ambiente de hospedagem, mantendo a exibição de erros longe dos visitantes públicos sempre que possível. Quando a mensagem identificar um componente ou uma operação, desative, restaure ou corrija essa causa específica e teste novamente. Uma página em branco não deve ser tratada automaticamente como uma falha do banco de dados.

Consulte [Tela Branca da Morte do WordPress](/wordpress-white-screen-of-death) para ver a sequência de diagnóstico.

Erro ao estabelecer uma conexão com o banco de dados

A mensagem Error Establishing a Database Connection significa que o WordPress não conseguiu se conectar ao banco de dados MySQL ou MariaDB. Verifique os valores do nome do banco de dados, nome de usuário, senha e host em wp-config.php, registrando os valores originais antes de fazer qualquer alteração.

Se as configurações parecerem corretas, determine se o serviço de banco de dados pode ser alcançado pelo ambiente de hospedagem e se o usuário do banco ainda tem o acesso necessário. Tabelas corrompidas são outra possibilidade, mas o reparo do banco de dados deve vir depois das verificações de conexão e configuração. Proteja um backup disponível antes de fazer alterações de reparo.

Consulte [WordPress: Erro ao estabelecer uma conexão com o banco de dados](/wordpress-error-establishing-a-database-connection) para uma explicação passo a passo.

Erros de memória esgotada do WordPress

Um erro como Allowed memory size of X bytes exhausted significa que um processo PHP usou mais memória do que o memory_limit configurado permite. Aumentar o limite disponível pode permitir que a requisição seja concluída, mas isso não explica por que o uso de memória aumentou.

Verifique se o erro começou durante uma alteração de plugin ou tema, uma importação, um backup, uma tarefa de mídia ou outra operação que consuma muitos recursos. Analise a configuração de memória disponível para o site e use os detalhes do erro para identificar a requisição ou o componente envolvido. Se a mesma operação esgotar a memória repetidamente, investigue a operação dispendiosa em vez de aumentar o limite indefinidamente.

Consulte [Erro de memória esgotada do WordPress](/wordpress-memory-exhausted-error) para correção imediata e diagnóstico de longo prazo.

Um processo prático para diagnosticar erros do WordPress

1. Registre o sintoma exato. Anote a mensagem, o status HTTP, a URL ou tarefa afetada, se a página está em branco e se o painel continua disponível.
2. Determine o momento da falha. Procure uma atualização recente de plugin ou tema, alteração no WordPress ou PHP, edição de configuração, migração, importação, backup ou evento de hospedagem.
3. Separe os sintomas de PHP, da aplicação e do banco de dados. Uma mensagem de erro fatal do PHP, uma página em branco e uma resposta 500 indicam um ponto de partida diferente de um erro direto de conexão com o banco de dados.
4. Verifique os logs ou a saída de depuração. O nome do componente, o arquivo PHP, a operação e a mensagem de erro completa são mais úteis do que uma falha genérica do navegador.
5. Teste uma causa provável por vez. Desative ou reverta o componente mais relacionado ao momento da falha e repita a requisição que falhou.
6. Verifique as funções públicas e administrativas. Uma página inicial funcionando não prova que o login, a publicação, os formulários, as importações ou outras requisições afetadas estejam funcionando corretamente.
7. Documente a alteração bem-sucedida. Registre o que foi revertido ou ajustado antes de tentar outra atualização ou alteração de configuração.

O que evitar

• Não desative todos os plugins e altere o tema simultaneamente se precisar isolar a causa.
• Não presuma que uma resposta 500 significa que o servidor de hospedagem está indisponível; o código do WordPress pode acioná-la.
• Não aumente repetidamente a memória do PHP sem identificar a operação que a está consumindo.
• Não substitua as configurações do banco de dados sem preservar os valores originais e considerar um backup disponível.
• Não exponha erros detalhados do PHP aos visitantes públicos por mais tempo do que o necessário.
• Não trate uma atualização do navegador como diagnóstico. Logs, testes controlados e a mensagem de erro exata fornecem evidências mais fortes.

Comece pelo guia cujo sintoma mais se aproxima do que visitantes ou administradores veem. O objetivo não é apenas restaurar a página, mas distinguir uma atualização problemática, um erro fatal oculto do PHP, um problema de acesso ao banco de dados e um limite de recursos, para que a falha subjacente possa ser tratada com segurança.