Falhas no Joomla geralmente envolvem versão incompatível do PHP, extensão ou template, arquivos incompletos, permissões, cache, banco ou regras de URL. Evite substituir arquivos aleatoriamente. Registre o erro, preserve logs e faça backup antes de alterar produção.
Comece pelo contexto
- URL e mensagem completas;
- horário e usuário afetado;
- última atualização, extensão ou mudança de PHP;
- versão do Joomla, PHP e banco;
- se frontend, administrador e CLI falham da mesma forma;
- espaço disponível e status do backup.
Onde encontrar o erro real
Consulte Errors/Erros e métricas no cPanel, o arquivo de log configurado pelo Joomla e, em VPS, logs do servidor web/PHP-FPM. Ative relatório detalhado ou depuração somente por tempo curto, para IP restrito ou em homologação. Não exponha stack trace, caminhos, consultas e tokens aos visitantes.
Erro 500 ou tela branca
- Verifique sintaxe e log no horário exato.
- Confirme que a versão do PHP atende ao Joomla e às extensões.
- Teste renomear temporariamente o
.htaccess, preservando uma cópia. - Revise permissões, proprietário e arquivos modificados.
- Desative a extensão recém-alterada pelo método seguro disponível.
- Confira memória e espaço, mas não aumente limites sem analisar consumo.
404 depois de ativar URLs amigáveis
Confirme que o rewrite está disponível, que o arquivo distribuído pelo Joomla foi renomeado corretamente quando necessário e que a base URL corresponde ao caminho real. Em subpasta, revise regras e proxy. Limpe cache do Joomla e do CDN depois da correção; não crie redirecionamentos em cadeia.
Site sem CSS, JavaScript ou imagens
Abra as ferramentas do navegador e veja status e URL dos recursos. Corrija conteúdo misto HTTP/HTTPS, domínio antigo, caminho com maiúsculas diferente e cache. Não aplique permissões 777. Uma migração pode preservar no banco URLs absolutas ou apontar CDN para a origem antiga.
Falha ao instalar ou atualizar extensão
- confirme compatibilidade com a versão do Joomla e PHP;
- baixe da fonte oficial do desenvolvedor;
- verifique limites de upload, espaço e diretórios temporários/log;
- revise update sites e licença quando aplicável;
- não force instalação de pacote destinado a outra versão;
- teste restauração antes de repetir.
Atualização do Joomla interrompida
Não recarregue ou substitua o core sem entender o estado. Preserve banco e arquivos, confira log e documentação da versão de origem/destino. Restaure a cópia consistente ou conclua o procedimento oficial. Atualizações entre gerações podem exigir etapa intermediária, plugin de compatibilidade e versões específicas de extensões.
Erro de banco
Confirme host, nome completo, usuário, senha e privilégios no arquivo de configuração sem publicá-los. Verifique se o serviço está ativo e se o banco não excedeu limite. Reparos e mudanças de estrutura devem ser feitos com backup e pela ferramenta do Joomla ou procedimento documentado, não por consultas encontradas ao acaso.
Administrador não abre ou login retorna
Teste janela privada, cookies e URL HTTPS. Revise extensões de autenticação, sessão e cache. Para redefinir acesso, use o método oficial compatível com sua versão e reverta a alteração temporária depois. Nunca deixe conta administrativa conhecida ou senha provisória ativa.
Isolar extensão ou template
Em homologação, reproduza o erro e desative um componente por vez. Comece pelo que mudou. Use o template padrão compatível como teste, mas preserve configurações. Se precisar agir no banco porque o painel não abre, faça backup e registre exatamente o valor anterior.
Depois de corrigir
- desative debug e exibição pública de erros;
- remova arquivos temporários e credenciais de suporte;
- atualize componentes vulneráveis;
- valide frontend, administrador, formulários, cron e e-mail;
- monitore logs e faça novo backup;
- documente causa, correção e prevenção.
Consulte os requisitos oficiais do Joomla, o guia de instalação no cPanel, diagnóstico de erro 500 e alteração de PHP.
Recursos relacionados
Continue com materiais e serviços relacionados ao tema deste guia.
Assistente IA WGS