// справочник ошибок MySQL

Ошибка MySQL 2003: Не удается подключиться к серверу MySQL на хосте

Клиент не смог открыть TCP-соединение с указанным хостом и портом. Сервер не запущен, слушает другой адрес или на пути стоит брандмауэр.

Номер ошибки
2003
Имя
CR_CONN_HOST_ERROR
Категория
Соединение и клиент
Сообщение об ошибке
Can't connect to MySQL server on '%s:%u' (%d)

Что это значит

2003 возникает на стороне клиента, когда само TCP-соединение не удается. Число в скобках — это ошибка операционной системы: (111) или (10061) в Windows означает отказ в соединении (никто не слушает), (110) или (10060) означает, что время ожидания истекло (обычно пакеты молча теряет брандмауэр), и (113) означает отсутствие маршрута к хосту.

Сервер даже не увидел попытку входа, поэтому пароль и права доступа здесь пока ни при чём.

Распространённые причины

  • Сервер не запущен или прослушивает порт, отличный от 3306.
  • Сервер прослушивает только 127.0.0.1 (bind_address), поэтому удалённые подключения отклоняются.
  • Брандмауэр, группа безопасности или правило облачной сети блокирует порт 3306.
  • Неверное имя хоста или IP-адрес в настройках подключения.

Как исправить

  1. На сервере проверьте, что MySQL запущен и на каком адресе и порте он слушает.

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. Чтобы разрешить удалённые подключения, установите bind_address = 0.0.0.0 (или собственный IP сервера) в [mysqld] раздел конфигурационного файла и перезапустите MySQL. Убедитесь, что учётная запись для удалённого хоста существует.

  3. Откройте порт в брандмауэре сервера и в любой облачной группе безопасности, затем протестируйте с клиентской машины, например с помощью nc -vz db.example.com 3306.

Связанные ошибки

Больше ошибок подключения и клиента

Код и текст сообщения взяты из Справочник сообщений об ошибках MySQL 8.4. Смотрите весь Список ошибок MySQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с MySQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для MySQL и других баз данных, которые вы используете.