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

Ошибка MySQL 2002: Не удается подключиться через сокет

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

Номер ошибки
2002
Имя
CR_CONNECTION_ERROR
Категория
Соединение и клиент
Сообщение об ошибке
Can't connect to local MySQL server through socket '%s' (%d)

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

Когда вы подключаетесь к localhost на Unix клиенты MySQL используют файл Unix-сокета вместо TCP. 2002 означает, что файла сокета нет или на нём никто не слушает. Число в скобках — это ошибка операционной системы, например (2) для «такого файла нет» и (111) для «соединение отклонено».

Это клиентская ошибка: запрос так и не дошёл до сервера.

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

  • Сервер MySQL не запущен либо аварийно завершил работу при запуске.
  • Сокет сервера находится в другом месте, чем ожидал клиент (например /var/run/mysqld/mysqld.sock по сравнению с /tmp/mysql.sock).
  • Сервер работает в Docker или на другой машине, поэтому локального сокета нет; нужен TCP.
  • Права на каталог сокета не дают клиенту до него добраться.

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

  1. Проверьте, запущен ли сервер, и прочитайте его журнал ошибок, если он не запущен, например с помощью systemctl status mysql на Linux или brew services list на macOS.

  2. Подключитесь через TCP вместо сокета, используя 127.0.0.1 вместо localhost, или --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. Если сервер работает локально, найдите путь к его сокету и направьте клиент туда.

    -- On the server:
    SHOW VARIABLES LIKE 'socket';
    -- Client:
    mysql --socket=/var/run/mysqld/mysqld.sock -u app -p

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

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

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

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

Работа с MySQL в SQLly

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