Passar para o conteúdo principal

Solucionando o erro “Error Establishing a Database Connection” / “Falha ao estabelecer conexão com o banco de dados”

Veja alguns passos para identificar possíveis problemas com a configuração ou com o servidor de banco de dados mysql.

Gustavo Luppi avatar
Escrito por Gustavo Luppi
Atualizado hoje

Esse erro é muito comum em sites que utilizam WordPress, Laravel, Joomla, Magento e outras aplicações que dependem de um banco de dados MySQL. Ele indica que o site não conseguiu se conectar ao banco de dados, impedindo o carregamento de páginas e funcionalidades.

Abaixo apresentamos as causas mais comuns e como corrigir em cPanel e DirectAdmin

1. Usuário, senha ou nome do banco de dados incorretos

Essa é a causa mais frequente. Verifique se o arquivo de configuração do site está usando os dados corretos.

Onde ajustar as credenciais?

WordPress

Arquivo: wp-config.php

Laravel

Arquivo: .env

Nesses arquivos, confira:

• DB_NAME

• DB_USER

• DB_PASSWORD

• DB_HOST

Como confirmar os dados no cPanel

1. Acesse o cPanel.

2. Vá em MySQL® Databases.

3. Verifique:

• Nome do banco

• Nome do usuário

• Senha (pode redefinir se necessário)

• Se o usuário está atribuído ao banco

Como confirmar os dados no DirectAdmin

1. Acesse o DirectAdmin.

2. Vá em Account Manager → MySQL Management.

3. Selecione o banco de dados.

4. Verifique:

• Nome do banco

• Usuários associados

• Permissões

• Opção de Change Password para redefinir a senha do usuário

Atualize as credenciais no arquivo de configuração do site caso estejam diferentes.

2. Usuário sem permissões suficientes no banco

O usuário precisa ter permissões totais para acessar e manipular as tabelas.

No cPanel

1. Acesse MySQL® Databases.

2. Role até Add User to Database.

3. Vincule o usuário ao banco.

4. Marque ALL PRIVILEGES.

No DirectAdmin

1. Acesse MySQL Management.

2. Clique no banco de dados.

3. Veja se o usuário correto está listado.

4. Se necessário, adicione um novo usuário ou ajuste permissões.

3. Banco de dados corrompido

Falhas de escrita, interrupções ou plugins ruins podem danificar tabelas.

Como reparar no cPanel

1. Acesse phpMyAdmin.

2. Entre no banco de dados.

3. Marque todas as tabelas.

4. Selecione Repair table.

Como reparar no DirectAdmin

1. Acesse phpMyAdmin (link disponível no painel).

2. Selecione o banco.

3. Marque todas as tabelas.

4. No menu inferior, escolha Repair table.

4. Serviço MySQL/MariaDB sobrecarregado ou momentaneamente indisponível

Pode ocorrer em ambientes compartilhados.

O que fazer?

• Aguardar alguns minutos.

• Verificar nossa Página de Status: https://status.rapidcloud.com.br

• Caso persistam falhas, abra um ticket para análise.

5. Configuração incorreta do DB_HOST

Na maioria dos casos, o host é localhost, tanto no cPanel quanto no DirectAdmin.

Mas em configurações externas, o host pode ser diferente.

Como confirmar:

cPanel

Em MySQL® Databases, veja o campo “Host”.

DirectAdmin

Em MySQL Management, ao selecionar o banco, verifique o Host do usuário do banco de dados.

6. Alto consumo de recursos

Consultas pesadas, plugins mal otimizados ou tráfego alto podem derrubar a conexão.

Recomendações

• Revise plugins e temas.

• Ative logs de debug temporariamente.

• Otimize tabelas via phpMyAdmin.

7. Banco de dados removido ou renomeado

O banco pode ter sido excluído acidentalmente.

Como verificar:

No cPanel

Acesse MySQL® Databases e procure na lista.

No DirectAdmin

Acesse MySQL Management e confira se o banco ainda existe.

Caso tenha sido excluído

Restaure via JetBackup, caso o seu plano tenha backup disponível.

8. Firewall bloqueando conexão (para bancos externos)

Se o banco está em outro servidor:

• Verifique liberação da porta 3306

• Adicione o IP da hospedagem à whitelist

• Confirme permissões de acesso remoto

Quando acionar o suporte?

Se após as verificações o problema persistir, nossa equipe poderá:

• revisar logs MySQL/MariaDB

• confirmar permissões e integridade das tabelas

• restaurar backups

• identificar falhas específicas na aplicação

Abra um ticket para que possamos ajudar.

Conclusão

O erro normalmente se relaciona a credenciais incorretas, permissões inadequadas ou falhas temporárias no MySQL/MariaDB.

Com este guia, você consegue identificar e corrigir a maior parte dos casos, seja utilizando cPanel ou DirectAdmin.

Respondeu à sua pergunta?