Tempo estimado: 3–8 min | Nível: Iniciante
Se você vê a mensagem “Erro ao estabelecer uma conexão com o banco de dados” (ou similar), normalmente é por credenciais incorretas, host do banco errado ou acesso remoto bloqueado. Siga os passos abaixo.
1) Acesse o cPanel
Entre em https://SEUDOMINIO.com/cpanel com seu usuário e senha.
Atalho: também funciona SEUDOMINIO.com.br/cpanel.
2) Verifique o acesso MySQL Remoto
No cPanel, procure por MySQL Remoto e abra a ferramenta.
Adicionar o host que precisa conectar
Se sua aplicação/servidor fora do cPanel precisa acessar o banco, adicione o IP público dele em Adicionar host e Salvar.
- Recomendado: informe o IP específico (ex.:
200.200.200.200). - Alternativa avançada:
%(curinga) libera de qualquer IP e não é recomendado por segurança.
Use sempre que possível o IP exato do cliente (servidor, ERP, app). Evite o curinga
%.3) Confirme usuário, senha e privilégios do banco
- No cPanel, entre em MySQL® Databases.
- Confira o nome do banco (
usuario_bd) e o usuário MySQL (usuario_user). - Se necessário, altere a senha do usuário e adicione o usuário ao banco com All Privileges.
4) Ajuste o arquivo de configuração do seu site
Verifique no sistema (ex.: WordPress) se os dados batem com o cPanel.
WordPress (wp-config.php)
define('DB_NAME', 'USUARIO_BD');
define('DB_USER', 'USUARIO_USER');
define('DB_PASSWORD', 'SENHA_AQUI');
define('DB_HOST', 'localhost'); // ou o host/IP do banco se externo
- Hospedagem no mesmo cPanel? Use
localhostemDB_HOST. - Banco externo? Use o host/IP externo liberado no MySQL Remoto.
5) Testes rápidos
- Troque a senha do usuário MySQL no cPanel e atualize no sistema.
- Se for conexão externa, confirme que a porta 3306 está liberada na origem.
- Cheque se o nome do banco inclui o prefixo do cPanel (ex.:
cpuser_meubanco).
Erros comuns e soluções
- Access denied for user: usuário/senha errados ou usuário sem privilégio no banco.
- Unknown database: nome do banco não existe ou digitado com erro.
- Can’t connect to MySQL server: host/porta incorretos ou IP não liberado no MySQL Remoto.
Modelo para abrir ticket
Assunto: Erro ao conectar ao banco de dados
Domínio: [seudominio.com.br] | Aplicação: [WordPress / outro]
DB_NAME/USER (sem senha): [copie do wp-config.php]
DB_HOST: [localhost / IP externo]
Print do erro: [anexe imagem]
Precisa de ajuda?
- WhatsApp: Conversar no WhatsApp
- Ticket/Chat: acesse sua Área do Cliente e abra um chamado.
Palavras-chave: erro banco de dados, MySQL remoto, cPanel, adicionar host, porta 3306, wp-config.php, credenciais MySQL, Access denied, Unknown database
