Mensagens como Erro ao estabelecer conexão com o banco de dados normalmente indicam falha nas credenciais, permissões, disponibilidade do serviço ou configuração da aplicação.
Verifique nesta ordem
- Nome do banco: use o nome completo exibido pelo cPanel, incluindo o prefixo.
- Usuário: confirme o nome completo e se ele ainda existe.
- Senha: verifique se foi alterada no cPanel sem atualização na aplicação.
- Servidor: em aplicações hospedadas na mesma conta, normalmente é
localhost. - Associação: confirme se o usuário está vinculado ao banco.
- Privilégios: revise as permissões concedidas.
- Espaço da conta: quota esgotada pode impedir gravações e provocar erros indiretos.
- Integridade: consulte se as tabelas existem e se o banco não está corrompido.
Onde ficam as credenciais
O local depende da aplicação. Exemplos comuns:
- WordPress:
wp-config.php; - Laravel e outras aplicações modernas: arquivo
.env; - sistemas personalizados: arquivo de configuração próprio.
Faça backup antes de editar. Arquivos de configuração contêm credenciais e não devem ser enviados publicamente.
Teste pelo cPanel
Acesse Gerenciar Meus Bancos de Dados para confirmar banco, usuário e associação. Use o phpMyAdmin para verificar se o banco abre e se as tabelas estão presentes. Conseguir abrir o phpMyAdmin não confirma, sozinho, que a aplicação está usando as mesmas credenciais.
Depois de migrar um site
Verifique se os nomes receberam novo prefixo, se o usuário foi recriado, se os privilégios foram concedidos e se o arquivo de configuração foi atualizado. Em uma migração, copiar apenas os arquivos não transfere automaticamente o banco.
Quando acionar o suporte
Se os dados estiverem corretos e o erro persistir, envie para suporte@invirtua.com.br:
- domínio afetado;
- horário aproximado do erro;
- mensagem completa;
- operação realizada antes do problema;
- nome do banco e do usuário, sem informar a senha.
