O site não abre, a loja não aceita encomendas ou o painel deixou de aceitar o início de sessão depois de uma atualização. Sou Mariusz Szatkowski, programador WordPress desde 2006, e faço estas reparações pessoalmente: começo pelos factos, faço uma cópia, isolo a camada que falhou e testo a correção nos mesmos percursos onde o problema apareceu. Esta página descreve também a manutenção que torna as falhas menos frequentes.
Com quem trabalha
- WordPress comercial desde 2006, antes do Gutenberg e da REST API
- Conduzido por sénior: o engenheiro do discovery é o mesmo na semana seis
- Sem passagem para offshore, sem camada de PM faturada
- Organizador da WordCamp Europe, mentor WordPress Foundation Credits
- Shopify Academy: percurso CRO e Partner Marketing (Credly, 2025)
Reparação de site WordPress: sintoma, causa e primeiro passo seguro
As falhas mais comuns têm causas descritas na documentação do WordPress. A tabela mostra o que costuma estar por trás de cada sintoma e o que pode verificar sem agravar a situação. Se o primeiro passo não ajudar ou se não tiver acesso aos ficheiros, pare e envie-me uma descrição.
| Sintoma | Causa mais frequente | Primeiro passo seguro |
|---|---|---|
| Ecrã branco sem mensagem | Erro de PHP num plugin ou no tema, muitas vezes logo após uma atualização | Por SFTP, mude o nome da pasta wp-content/plugins e, se não resultar, o da pasta do tema ativo |
| ”Ocorreu um erro crítico neste site.” | Erro fatal de PHP intercetado pelo WordPress (desde a versão 5.2) | Abra o e-mail do endereço de administrador: a mensagem traz uma ligação para o modo de recuperação, que suspende o plugin responsável |
| 500 Internal Server Error | .htaccess danificado, um plugin ou o limite de memória | Mude o nome do .htaccess e, quando o site voltar, guarde de novo Opções, Ligações permanentes |
| Erro ao estabelecer uma ligação com a base de dados | Dados errados no wp-config.php ou servidor de base de dados em baixo | Compare DB_NAME, DB_USER, DB_PASSWORD e DB_HOST com o painel do alojamento e pergunte ao alojamento pelo estado do MySQL |
| Allowed memory size exhausted | Limite de memória do PHP baixo ou código que consome memória em ciclo | Aumente WP_MEMORY_LIMIT no wp-config.php e depois descubra o que consome a memória, porque o limite sozinho só adia o problema |
| Site preso em modo de manutenção | Uma atualização interrompida deixou o ficheiro .maintenance | Apague o .maintenance da pasta raiz e conclua a atualização que ficou a meio |
| Redirecionamentos para sites estranhos, spam nos resultados do Google | Intrusão, normalmente por um plugin desatualizado ou abandonado | Não apague ficheiros às cegas: faça uma cópia como prova, mude as palavras-passe do painel, do SFTP e da base de dados e só depois limpe, como descrito em remover malware do WordPress |
| A loja WooCommerce não aceita encomendas | Conflito de plugins, cache no carrinho ou erro do gateway de pagamento | Abra WooCommerce, Estado, Registos e veja em que passo a encomenda fica parada |
Fontes: Common WordPress Errors, Debugging in WordPress, Fatal Error Recovery Mode in 5.2, FAQ My site was hacked.
Pedidos urgentes
Não tenho serviço de piquete 24/7, SLA nem prazos de reparação garantidos. Trabalho sozinho, por isso digo-lhe por escrito, depois de ler a descrição, quando consigo começar. Um site em produção parado passa à frente do trabalho planeado sempre que a minha agenda o permite.
Se o site foi criado ou muito alterado por uma ferramenta de IA, a reparação é outra: o código gerado esconde pressupostos errados em vez de erros óbvios. Trato isso como trabalho à parte, na recuperação de sites feitos por IA.
Veja o que o seu site mostra em público
Indique o endereço de um site que gere. Nós obtemo-lo como faria um navegador e mostramos o que daí decorre, junto com aquilo que lemos exactamente.
Cole o endereço do seu site. A ferramenta carrega-o como o navegador de um visitante e mostra o código de resposta depois dos redirecionamentos, os cabeçalhos, o peso do carregamento inicial e os vestígios do WordPress. Não inicia sessão nem vê o painel, por isso não substitui um diagnóstico, mas o resultado colado no pedido poupa uma ronda de perguntas. A descrição completa do que a ferramenta mede está na página de verificação de site WordPress.
Como decorre a reparação
- Pedido com factos. URL da página, momento da falha, alterações recentes e o que está bloqueado: carrinho, início de sessão ou publicação.
- Cópia antes da alteração. Ponto de restauro dos ficheiros e da base de dados e, quando o incidente o permite, reprodução do erro fora da produção.
- Isolamento da camada. Alojamento, núcleo, tema, plugin, código personalizado, API externa, cache ou DNS. Corrijo a camada responsável e só essa.
- Verificação e nota. Volto a testar o cenário do pedido e os percursos vizinhos, e registo numa nota a alteração e o ponto de reversão.
Os registos do navegador e do servidor, a hora exata e os passos para reproduzir o erro poupam mais tempo de diagnóstico do que capturas de ecrã. Por isso peço-os logo no primeiro e-mail.
A reparação só termina quando o cenário original e os percursos vizinhos voltam a funcionar. Num erro de checkout não basta a página do carrinho abrir: testo o pagamento, a confirmação, o e-mail ao cliente e o movimento de stock. Num erro editorial testo a pré-visualização, a publicação, a biblioteca multimédia, as permissões e a limpeza da cache. Se a causa estiver fora do meu alcance, por exemplo num serviço externo, entrego as provas e uma forma segura de conter o problema, sem apresentar um remendo como correção definitiva.
O que preparar antes de pedir ajuda
No início de uma falha, a maior parte do tempo vai para obter acessos e perceber o que mudou.
Descrição da falha
- URL da página onde o problema é visível
- quando apareceu pela primeira vez
- o que mudou imediatamente antes: atualização, plugin novo, migração, alteração de DNS
- texto da mensagem de erro ou captura de ecrã
Acessos
- uma conta de administrador WordPress criada para mim, não a sua
- SFTP ou SSH aos ficheiros do site
- painel do alojamento com acesso à base de dados e aos registos de erros
- numa loja: acesso só de consulta ao painel do gateway de pagamento
Envie os acessos por um canal separado, não no texto do formulário. Quando o trabalho terminar, apague a conta e mude a palavra-passe do SFTP, como faria com qualquer prestador. As recomendações do WordPress sobre palavras-passe, contas e permissões estão no guia Hardening WordPress.
Suporte WooCommerce: quando a loja deixa de vender
Uma falha na loja custa mais do que num site institucional, porque cada hora parada são encomendas que não entram. No WooCommerce, a página inicial voltar a abrir não prova nada: a reparação só termina quando uma encomenda de teste passa pelo carrinho, pelo pagamento (Multibanco, MB WAY ou cartão, conforme o gateway), pelo e-mail de confirmação e pela atualização do stock. O WooCommerce guarda os erros em WooCommerce, Estado, Registos, e o relatório de estado do sistema, na mesma secção, mostra o ambiente, as versões e os modelos substituídos pelo tema. Junte ambos ao pedido.
Quando a loja funciona mas perde encomendas, pagamentos ou integrações há algum tempo, um sprint de recuperação WooCommerce com âmbito fechado resolve melhor do que reparações avulsas.
Manutenção depois da reparação
Grande parte das falhas desta página nasce de atualizações feitas à pressa ou adiadas durante meses. Na manutenção WordPress faço o seguinte:
- atualizações do núcleo, dos temas e dos plugins, testadas primeiro em staging;
- monitorização de disponibilidade a cada 1 a 5 minutos;
- cópias de segurança guardadas pelo menos 30 dias em países da UE, com restauração testada;
- manutenção do tema personalizado que construí a partir do layout que o cliente fornece.
Antes do primeiro acesso assinamos um acordo de subcontratação nos termos do artigo 28.º do RGPD. Nenhuma manutenção garante proteção total contra ataques. O que reduz o estrago é haver uma cópia recente guardada fora do servidor e alguém que saiba restaurá-la.
Descreva o que está a ver
O endereço, o momento da falha e as alterações recentes chegam para começar. Envie-os pelo formulário de contacto. O orçamento é individual e chega por escrito depois da descrição, e o trabalho arranca quando o âmbito estiver acordado.
