Erro: por que recebo 'connection refused' ao conectar com banco de dados Print

Erro: Por que recebo 'Connection Refused' ao conectar com o banco de dados?

Olá, querido(a) cliente! 👋 Se você está vendo a mensagem "Connection Refused" ao tentar se conectar ao banco de dados do seu site, não se preocupe — isso é mais comum do que parece, e eu, sua Sensei da GeHost, vou te guiar passo a passo para resolver isso com calma, clareza e um toque de paciência. Vamos juntos?

🔍 O que significa "Connection Refused"?

Essa mensagem quer dizer que o servidor onde seu banco de dados está hospedado recusou a conexão. Pode ser por vários motivos, mas os mais comuns são:

• Nome do servidor do banco de dados incorreto.
• Usuário ou senha errados.
• Permissões do usuário não permitirem acesso remoto.
• Firewall ou configuração de segurança bloqueando a conexão.

Calma! Vamos resolver isso com um passo a passo simples e seguro.

✅ Passo a passo para resolver o erro

1. Verifique o nome do servidor do banco de dados

   Em geral, o nome do servidor do banco de dados é algo como localhost ou um endereço específico fornecido pela hospedagem. No caso da GeHost, o servidor é sempre localhost para conexões locais (como em scripts PHP).

   Dica: Nunca use IP ou nomes de servidor como "db1.gehost.com" a menos que seja explicitamente indicado. Na maioria dos casos, localhost é o caminho certo.

2. Confira o nome do banco de dados, usuário e senha

   Esses dados estão no painel da GeHost. Vá até o MySQL Databases no cPanel:

   

   Na tela, verifique:

   • O nome do banco de dados (ex: meubanco).
   • O nome do usuário (ex: meu_usuario).
   • A senha (não se esqueça de copiá-la corretamente).

   Se você mudou a senha recentemente, certifique-se de que o novo valor está no seu script.

3. Verifique se o usuário tem permissão para acessar o banco

   Na mesma tela do MySQL Databases, clique em “Add User to Database” (ou “Adicionar Usuário ao Banco”).

   Seu usuário precisa estar associado ao banco de dados com permissões adequadas (geralmente ALL PRIVILEGES).

   Se o usuário não aparecer na lista, ele não está vinculado ao banco. Faça a associação correta.

4. Evite conexões remotas (a menos que necessário)

   Por segurança, a GeHost desativa conexões remotas por padrão. Isso significa que você só pode se conectar ao banco de dados do próprio servidor onde seu site está hospedado.

   Se você está tentando se conectar de um computador externo (como seu laptop com XAMPP, ou um servidor em outro lugar), isso será recusado.

   Dica: Só tente conexões remotas se for absolutamente necessário e com permissão especial. Em 99% dos casos, o erro “Connection Refused” acontece por tentar conectar de fora.

5. Teste com um script simples

   Crie um arquivo temporário (ex: test_db.php) no seu site com este código:

   <?php
   $host = 'localhost';
   $dbname = 'nome_do_seu_banco';
   $username = 'nome_do_usuario';
   $password = 'sua_senha';
   
   try {
       $pdo = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
       echo "Conexão bem-sucedida!";
   } catch (PDOException $e) {
       echo "Erro: " . $e->getMessage();
   }
   ?>

   Suba esse arquivo para o seu site (via File Manager) e abra no navegador. O resultado vai te mostrar o erro exato.

   

💡 Dicas finais da Sensei

• Seu banco de dados só pode ser acessado do seu próprio site — não de fora.
• Nunca coloque dados sensíveis (como senha do banco) em arquivos públicos.
• Se você está usando um sistema como WordPress, PrestaShop ou outro CMS, certifique-se de que o arquivo de configuração (como wp-config.php) tem os dados corretos.
• Se nada funcionar, entre em contato com o suporte da GeHost. Nós estamos aqui para te ajudar! 💬

Se você seguiu todos os passos e ainda tem dúvidas, não hesite: peça ajuda. Afinal, o erro é só um sinal de que algo pode ser ajustado — e você já está no caminho certo. 🌟