Erros comuns no WordPress e como resolver cada um

Quase todo erro do WordPress vem de três lugares: um plugin ou tema com problema, uma configuração errada no wp-config.php ou no .htaccess, ou um limite do PHP, como memória e tamanho de envio. A mensagem na tela indica qual deles investigar primeiro.

Abaixo estão as mensagens mais comuns, do erro crítico ao wp-admin que não abre, com o que cada uma significa e como resolver. Comece sempre pela cópia de segurança e, se a mensagem for genérica, pelo modo de depuração.

Ver o erro real com o modo de depuração

Muitas falhas aparecem só como tela branca ou mensagem genérica. Para descobrir a causa, ative o registro de erros no wp-config.php, acima da linha que diz para parar de editar:

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

Tela branca ou "Há um erro crítico no seu site"

Quase sempre é um plugin ou tema com erro, em geral logo depois de uma atualização. O WordPress costuma enviar ao e-mail do administrador um link de modo de recuperação. Sem esse acesso, renomeie a pasta wp-content/plugins para plugins-off: todos os plugins são desativados. Se o site voltar, restaure o nome e desative um por um, renomeando a pasta de cada plugin, até achar o culpado. Para testar o tema, renomeie a pasta do tema ativo: o WordPress volta para um tema padrão instalado.

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

A mensagem costuma aparecer em inglês, mesmo em sites em português: "Error establishing a database connection". O WordPress não conseguiu falar com o banco de dados.

• Confira no wp-config.php os valores de DB_NAME, DB_USER, DB_PASSWORD e DB_HOST. Depois de uma migração, eles costumam estar errados.
• No painel, verifique se o usuário do banco está associado ao banco com todos os privilégios.
• Se os dados estão certos e o erro aparece só às vezes, o plano pode estar no limite de recursos nos horários de pico.

Erro 500 (Internal Server Error)

Renomeie o arquivo .htaccess da raiz do site para .htaccess-old. Se o site voltar, entre no painel do WordPress, em Configurações > Links permanentes, e clique em Salvar: um .htaccess novo e limpo é gerado. Se não resolver, siga os passos da tela de erro crítico.

"Allowed memory size exhausted"

O PHP atingiu o limite de memória. Aumente o memory_limit no editor de configurações do PHP do painel (no cPanel, MultiPHP INI Editor) e, se precisar, defina no wp-config.php:

define( 'WP_MEMORY_LIMIT', '256M' );

Se o consumo continua alto, algum plugin está pesado demais para o site. Aumentar a memória resolve o sintoma; trocar ou remover o plugin resolve a causa.

"Momentaneamente indisponível para manutenção programada"

Uma atualização foi interrompida e o arquivo .maintenance ficou na raiz do site. O WordPress passa a ignorar esse arquivo depois de 10 minutos, mas o caminho mais rápido é apagá-lo pelo gerenciador de arquivos e conferir se plugins e temas terminaram de atualizar.

Redirecionamento em loop (ERR_TOO_MANY_REDIRECTS)

• Em Configurações > Geral, os endereços do WordPress e do site precisam ser iguais e com https quando o SSL estiver ativo.
• Sem acesso ao painel, defina WP_HOME e WP_SITEURL no wp-config.php com o endereço correto.
• Plugins de SSL ou de cache e regras no .htaccess podem brigar entre si: desative-os para testar.

define( 'WP_HOME', 'https://exemplo.com.br' );
define( 'WP_SITEURL', 'https://exemplo.com.br' );

wp-admin não abre ou o login volta para a mesma tela

• Limpe os cookies do site ou teste numa janela anônima: cookies antigos fazem o login voltar para a tela de entrada.
• Acesse direto exemplo.com.br/wp-login.php. Se der página não encontrada, um plugin de segurança pode ter mudado o endereço de login; renomeie a pasta dele em wp-content/plugins para voltar ao padrão.
• Se o endereço do site mudou (troca de domínio ou de http para https), defina WP_HOME e WP_SITEURL como no item do loop de redirecionamento.
• Se o erro crítico aparece só no painel, siga os passos da tela de erro crítico: o culpado costuma ser um plugin que roda só na área administrativa.
• Depois de várias senhas erradas, o firewall do servidor pode bloquear o seu IP. Teste por outra rede, como os dados móveis do celular, e peça a liberação ao suporte da hospedagem.

Erro HTTP ao enviar imagens ou "arquivo grande demais"

O aviso genérico "Erro HTTP." na biblioteca de mídia costuma vir de imagem grande demais para o PHP processar, de tempo esgotado no processamento ou de uma regra do firewall de aplicação do servidor. Envie uma imagem pequena para isolar a causa e reduza a resolução das fotos antes de enviar.

Para arquivos acima do limite, aumente upload_max_filesize e post_max_size no editor de configurações do PHP. Se o erro for de permissão, as pastas de wp-content/uploads costumam precisar de permissão 755 e os arquivos de 644.

Imagens quebradas depois de mudar de domínio ou ativar o SSL

O WordPress grava no banco de dados os endereços completos das imagens e dos links internos. Depois de trocar de domínio ou passar para https, esses endereços continuam apontando para o antigo. Com o WP-CLI, o search-replace troca tudo, inclusive dados serializados de plugins; rode primeiro com --dry-run para ver o que vai mudar:

wp search-replace 'http://exemplo.com.br' 'https://exemplo.com.br' --skip-columns=guid --dry-run
wp search-replace 'http://exemplo.com.br' 'https://exemplo.com.br' --skip-columns=guid

Página não encontrada (404) em todos os posts

Os links permanentes perderam a regra de reescrita. Em Configurações > Links permanentes, clique em Salvar sem mudar nada.

Perguntas frequentes

Como descobrir qual plugin está quebrando o WordPress?

Use o link do modo de recuperação que o WordPress envia ao e-mail do administrador: ele mostra o plugin ou o tema que causou o erro. Sem o e-mail, ligue o WP_DEBUG_LOG e leia o wp-content/debug.log, ou renomeie a pasta de cada plugin, um por vez, até o site voltar.

O que significa erro 500 no WordPress?

É um erro interno do servidor: o PHP parou com um erro fatal ou o .htaccess tem uma regra inválida. Renomeie o .htaccess para testar e, se não resolver, procure a causa no debug.log ou no registro de erros do painel.

Por que o wp-admin não abre?

As causas mais comuns são cookies antigos, endereço do site errado depois de uma migração, um plugin de segurança que mudou o endereço de login ou um erro fatal de plugin que só aparece no painel. Teste numa janela anônima e acesse direto o wp-login.php antes de mexer em arquivos.

Posso deixar o WP_DEBUG ligado no site no ar?

Não. Use o modo de depuração só enquanto investiga e desligue depois, porque o debug.log pode expor caminhos do servidor e detalhes dos plugins. Se precisar deixar ligado por um tempo, mantenha WP_DEBUG_DISPLAY em false para os erros não aparecerem aos visitantes.