O erro 500 no WordPress \u00e9 um dos mais temidos: voc\u00ea acessa o site e v\u00ea a mensagem gen\u00e9rica \u201cErro interno do servidor\u201d. O site pode estar fora do ar, mas nem sempre \u00e9 um problema grave. Na maioria das vezes, \u00e9 um plugin ou tema que quebrou, um limite de mem\u00f3ria estourado ou um arquivo .htaccess corrompido.<\/p>\n
A pior estrat\u00e9gia \u00e9 sair desativando tudo \u00e0s cegas. Isso pode derrubar ainda mais o site, principalmente se voc\u00ea n\u00e3o tiver acesso ao painel. A ordem certa come\u00e7a pelo que n\u00e3o derruba nada: ativar o log de erros, verificar o que o servidor registrou e, s\u00f3 depois, mexer em plugins e tema.<\/p>\n
Neste guia, voc\u00ea vai aprender a diagnosticar o erro 500 no WordPress na ordem de risco crescente, usando ferramentas que j\u00e1 existem no seu servidor, sem precisar de conhecimentos avan\u00e7ados.<\/p>\n
O erro 500 \u00e9 uma resposta gen\u00e9rica do servidor: algo deu errado, mas o servidor n\u00e3o informa o motivo. As causas mais comuns s\u00e3o:<\/p>\n
.htaccess<\/code> corrompido ou com regras inv\u00e1lidas.<\/li>\n- Permiss\u00f5es de arquivos ou pastas incorretas.<\/li>\n
- Erro no
wp-config.php<\/code> ou em algum arquivo essencial.<\/li>\n- Problema no servidor (fora do seu controle).<\/li>\n<\/ul>\n
Como a mensagem n\u00e3o diz nada, o diagn\u00f3stico depende de voc\u00ea investigar. A boa not\u00edcia: a maioria das causas \u00e9 resolvida com passos simples, e voc\u00ea pode fazer isso sem derrubar o site ainda mais.<\/p>\n
Antes de come\u00e7ar: prepare um backup<\/h2>\n
Qualquer altera\u00e7\u00e3o no site pode piorar a situa\u00e7\u00e3o. Por isso, antes de qualquer passo, fa\u00e7a um backup completo: arquivos e banco de dados. Se algo der errado, voc\u00ea restaura em minutos.<\/p>\n
Se voc\u00ea n\u00e3o tem backup recente, veja o que precisa estar na c\u00f3pia para ela servir de verdade: Backup do WordPress: o que precisa estar na c\u00f3pia para ela servir<\/a>.<\/p>\nAl\u00e9m disso, se o site estiver fora do ar, avise sua equipe ou cliente. O diagn\u00f3stico pode levar alguns minutos, e \u00e9 melhor gerenciar a expectativa.<\/p>\n
Passo 1: Ative o log de erros do WordPress (sem derrubar nada)<\/h2>\n
O WordPress tem um sistema de log que grava erros de PHP em um arquivo. A maioria dos sites n\u00e3o ativa isso por padr\u00e3o, mas voc\u00ea pode ativar editando o wp-config.php<\/code>.<\/p>\nAten\u00e7\u00e3o:<\/strong> editar o wp-config.php<\/code> \u00e9 seguro se voc\u00ea seguir o passo a passo. N\u00e3o altere mais nada al\u00e9m das linhas indicadas.<\/p>\n\n- Acesse os arquivos do site via FTP ou gerenciador de arquivos da hospedagem.<\/li>\n
- Abra o arquivo
wp-config.php<\/code> na raiz do WordPress.<\/li>\n- Encontre a linha
define('WP_DEBUG', false);<\/code> (ou algo similar).<\/li>\n- Substitua por:<\/li>\n<\/ol>\n
define('WP_DEBUG', true);\ndefine('WP_DEBUG_LOG', true);\ndefine('WP_DEBUG_DISPLAY', false);<\/code><\/pre>\nIsso grava os erros em wp-content\/debug.log<\/code> sem exibi-los na tela (o que poderia expor informa\u00e7\u00f5es sens\u00edveis).<\/p>\nSalve o arquivo e acesse o site novamente. Se o erro 500 persistir, verifique o arquivo debug.log<\/code> \u2014 ele deve conter a causa exata, como \u201cPHP Fatal error: Call to undefined function\u201d ou \u201cAllowed memory size exhausted\u201d.<\/p>\nSe n\u00e3o houver log, o problema pode estar no servidor ou em algo fora do WordPress. Continue para os pr\u00f3ximos passos.<\/p>\n
Passo 2: Verifique os logs do servidor<\/h2>\n
Se o debug.log<\/code> n\u00e3o aparecer, o erro pode estar acontecendo antes do WordPress carregar. Nesse caso, verifique os logs de erro do servidor. A maioria dos pain\u00e9is (cPanel, Plesk, etc.) tem uma se\u00e7\u00e3o de \u201cLogs de Erros\u201d ou \u201cError Log\u201d.<\/p>\nSe voc\u00ea tem acesso SSH, pode ver os logs em tempo real com:<\/p>\n
tail -f \/var\/log\/apache2\/error.log<\/code><\/pre>\nOu, para Nginx:<\/p>\n
tail -f \/var\/log\/nginx\/error.log<\/code><\/pre>\nO caminho exato varia conforme a hospedagem. Consulte a documenta\u00e7\u00e3o do seu provedor ou pe\u00e7a suporte t\u00e9cnico.<\/p>\n
Os logs do servidor costumam mostrar erros de PHP, problemas de permiss\u00e3o ou falhas de m\u00f3dulos. Anote a mensagem exata \u2014 ela vai guiar o resto do diagn\u00f3stico.<\/p>\n
Passo 3: Aumente o limite de mem\u00f3ria do PHP (sem desativar nada)<\/h2>\n
Um dos erros mais comuns por tr\u00e1s do erro 500 \u00e9 o limite de mem\u00f3ria estourado. O WordPress precisa de pelo menos 64 MB, mas muitos sites usam mais. Voc\u00ea pode aumentar o limite sem desativar plugins ou temas.<\/p>\n
Adicione esta linha no wp-config.php<\/code>, logo ap\u00f3s a linha do WP_DEBUG<\/code>:<\/p>\ndefine('WP_MEMORY_LIMIT', '256M');<\/code><\/pre>\nIsso define o limite para 256 MB, suficiente para a maioria dos sites. Salve e teste.<\/p>\n
Se o erro persistir, o problema n\u00e3o \u00e9 mem\u00f3ria. Mas esse ajuste \u00e9 inofensivo e pode resolver de uma vez.<\/p>\n
Passo 4: Renomeie a pasta de plugins (m\u00e9todo seguro)<\/h2>\n
Se os logs apontam para um plugin, ou se voc\u00ea suspeita de um conflito, o pr\u00f3ximo passo \u00e9 desativar todos os plugins. Mas, em vez de desativar pelo painel (que pode estar inacess\u00edvel), voc\u00ea pode renomear a pasta de plugins via FTP.<\/p>\n
Por que isso \u00e9 mais seguro?<\/strong> Porque voc\u00ea n\u00e3o precisa acessar o painel, e pode reverter facilmente. Al\u00e9m disso, n\u00e3o desativa plugin por plugin \u2014 desativa todos de uma vez, o que \u00e9 mais r\u00e1pido para isolar o problema.<\/p>\n\n- Acesse
wp-content\/plugins<\/code> via FTP.<\/li>\n- Renomeie a pasta
plugins<\/code> para plugins_off<\/code>.<\/li>\n- Acesse o site. Se o erro 500 sumir, o problema \u00e9 um plugin.<\/li>\n
- Para descobrir qual, renomeie a pasta de volta para
plugins<\/code> e, um a um, renomeie cada subpasta de plugin (ex.: akismet<\/code> para akismet_off<\/code>) e teste o site a cada renomea\u00e7\u00e3o.<\/li>\n<\/ol>\nEsse processo pode ser demorado, mas \u00e9 o m\u00e9todo mais preciso. Se voc\u00ea suspeita de um plugin espec\u00edfico, comece por ele.<\/p>\n
Se o erro persistir com os plugins desativados, o problema n\u00e3o \u00e9 plugin. Siga para o pr\u00f3ximo passo.<\/p>\n
Passo 5: Troque para um tema padr\u00e3o (sem perder configura\u00e7\u00f5es)<\/h2>\n
Se os plugins n\u00e3o s\u00e3o a causa, o tema pode estar com erro. Para testar, voc\u00ea precisa trocar temporariamente para um tema padr\u00e3o do WordPress (como Twenty Twenty-Four).<\/p>\n
Como fazer sem acessar o painel:<\/strong> via FTP, renomeie a pasta do seu tema ativo em wp-content\/themes<\/code>. Por exemplo, se seu tema \u00e9 meu-tema<\/code>, renomeie para meu-tema_off<\/code>. O WordPress vai detectar que o tema sumiu e cair no tema padr\u00e3o automaticamente.<\/p>\nAcesse o site. Se o erro sumir, o problema \u00e9 do tema. Voc\u00ea pode reverter renomeando a pasta de volta, mas lembre-se de que o tema pode estar corrompido \u2014 talvez seja necess\u00e1rio reinstal\u00e1-lo ou corrigir o erro.<\/p>\n
Se o erro persistir, o problema est\u00e1 em outra parte: arquivos principais, banco de dados ou servidor.<\/p>\n
Passo 6: Verifique o arquivo .htaccess (se aplic\u00e1vel)<\/h2>\n
O .htaccess<\/code> \u00e9 um arquivo de configura\u00e7\u00e3o do Apache que pode causar erro 500 se tiver regras inv\u00e1lidas. Para testar, renomeie o arquivo para .htaccess_backup<\/code> via FTP.<\/p>\nAo acessar o site, o WordPress vai gerar um novo .htaccess<\/code> automaticamente (se tiver permiss\u00e3o de escrita). Se o erro sumir, o problema era o arquivo antigo. Voc\u00ea pode restaurar as regras personalizadas depois, ou deixar o novo.<\/p>\nAten\u00e7\u00e3o:<\/strong> se voc\u00ea usa regras de redirecionamento ou cache, vai precisar reconfigur\u00e1-las. Mas \u00e9 um passo seguro para diagn\u00f3stico.<\/p>\nPasso 7: Verifique permiss\u00f5es de arquivos e pastas<\/h2>\n
Permiss\u00f5es incorretas podem impedir o WordPress de ler arquivos essenciais, causando erro 500. As permiss\u00f5es padr\u00e3o s\u00e3o:<\/p>\n
\n- Pastas: 755<\/li>\n
- Arquivos: 644<\/li>\n
wp-config.php<\/code>: 600 (ou 644, dependendo da hospedagem)<\/li>\n<\/ul>\nVoc\u00ea pode corrigir via FTP: selecione todos os arquivos e defina as permiss\u00f5es. Ou, se tiver SSH, use:<\/p>\n
find \/caminho\/para\/wordpress -type d -exec chmod 755 {} \\;\nfind \/caminho\/para\/wordpress -type f -exec chmod 644 {} \\;<\/code><\/pre>\nTeste o site. Se o erro persistir, as permiss\u00f5es n\u00e3o s\u00e3o o problema.<\/p>\n
Passo 8: Reinstale os arquivos principais do WordPress<\/h2>\n
Se nada funcionou, os arquivos principais do WordPress podem estar corrompidos. Voc\u00ea pode reinstal\u00e1-los sem perder conte\u00fado, desde que n\u00e3o toque em wp-content<\/code> e wp-config.php<\/code>.<\/p>\n\n- Baixe a vers\u00e3o mais recente do WordPress em wordpress.org<\/a>.<\/li>\n
- Extraia o arquivo no seu computador.<\/li>\n
- Via FTP, envie os arquivos da pasta
wordpress<\/code> para a raiz do seu site, substituindo os existentes (exceto wp-content<\/code> e wp-config.php<\/code>).<\/li>\n- Confirme a substitui\u00e7\u00e3o quando solicitado.<\/li>\n<\/ol>\n
Isso substitui os arquivos principais, mantendo seu conte\u00fado e configura\u00e7\u00f5es. Teste o site.<\/p>\n
Quando N\u00c3O usar esta solu\u00e7\u00e3o<\/h2>\n
Este guia \u00e9 para erros 500 causados por problemas dentro do WordPress. Se o erro acontecer em todos os sites da mesma hospedagem, ou se o servidor estiver fora do ar, o problema \u00e9 da hospedagem \u2014 entre em contato com o suporte deles.<\/p>\n
Tamb\u00e9m n\u00e3o recomendamos mexer em arquivos se voc\u00ea n\u00e3o tem experi\u00eancia com FTP ou edi\u00e7\u00e3o de c\u00f3digo. Nesse caso, contrate um profissional ou use o servi\u00e7o de corre\u00e7\u00e3o de erros p\u00f3s-atualiza\u00e7\u00e3o do 100% WP.<\/p>\n
Erros comuns durante o diagn\u00f3stico<\/h2>\n\n- Esquecer de reverter as altera\u00e7\u00f5es:<\/strong> depois de resolver, desative o WP_DEBUG e restaure o limite de mem\u00f3ria se n\u00e3o precisar mais.<\/li>\n
- Renomear a pasta errada:<\/strong> confirme o nome exato da pasta do tema ou plugin antes de renomear.<\/li>\n
- Esquecer de limpar o cache:<\/strong> ap\u00f3s cada altera\u00e7\u00e3o, limpe o cache do navegador e do plugin de cache (se houver).<\/li>\n
- N\u00e3o fazer backup:<\/strong> qualquer erro de digita\u00e7\u00e3o pode piorar o site. Sem backup, voc\u00ea pode perder tudo.<\/li>\n<\/ul>\n
Como prevenir o erro 500<\/h2>\n
Manter o WordPress, plugins e temas atualizados reduz drasticamente a chance de erros. Al\u00e9m disso, monitore o limite de mem\u00f3ria e os logs regularmente.<\/p>\n
Se voc\u00ea gerencia v\u00e1rios sites, o 100% WP centraliza atualiza\u00e7\u00f5es, backups e monitoramento em um s\u00f3 lugar. Em vez de entrar em cada site para verificar erros, voc\u00ea acompanha tudo pelo painel \u2014 e ainda recebe alertas quando algo sai do ar. Veja os planos em 100porcentowp.com.br\/planos<\/a>.<\/p>\nSe o erro 500 for recorrente, considere aumentar o limite de mem\u00f3ria permanentemente ou revisar a qualidade dos plugins instalados. Plugins mal codificados s\u00e3o a causa mais comum.<\/p>\n
Quando chamar um profissional<\/h2>\n
Se voc\u00ea seguiu todos os passos e o erro persiste, ou se n\u00e3o se sente confort\u00e1vel editando arquivos, \u00e9 hora de pedir ajuda. Um profissional pode diagnosticar o problema em minutos com acesso SSH e ferramentas avan\u00e7adas.<\/p>\n