// Referência de erro do MySQL

Erro do MySQL 2003: não é possível conectar ao servidor MySQL no host

O cliente não conseguiu abrir uma conexão TCP com o host e a porta. O servidor está fora do ar, escuta em outro lugar ou há um firewall no caminho.

Número do erro
2003
Nome
CR_CONN_HOST_ERROR
Categoria
Conexão e cliente
Mensagem de erro
Can't connect to MySQL server on '%s:%u' (%d)

O que significa

2003 é gerado pelo cliente quando a conexão TCP em si falha. O número entre colchetes é o erro do sistema operacional: (111) ou (10061) no Windows significa conexão recusada (nada escutando), (110) ou (10060) significa tempo esgotado (geralmente um firewall descartando pacotes), e (113) significa nenhum caminho para o host.

O servidor nunca viu o login, então a senha e os privilégios ainda não importam.

Causas comuns

  • O servidor não está em execução, ou escuta em uma porta diferente de 3306.
  • O servidor só escuta em 127.0.0.1 (bind_address), então conexões remotas são recusadas.
  • Um firewall, grupo de segurança ou regra de rede na nuvem bloqueia a porta 3306.
  • Nome de host ou endereço IP incorreto nas configurações de conexão.

Como corrigir

  1. No servidor, verifique se o MySQL está em execução e em qual endereço e porta ele escuta.

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. Para aceitar conexões remotas, defina bind_address = 0.0.0.0 (ou o próprio IP do servidor) em [mysqld] seção do arquivo de configuração e reinicie o MySQL. Certifique-se de que exista uma conta para o host remoto.

  3. Abra a porta no firewall do servidor e em qualquer grupo de segurança de nuvem, depois teste a partir da máquina cliente, por exemplo com nc -vz db.example.com 3306.

Erros relacionados

Mais erros de conexão e do cliente

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.