// Referência de erro do MySQL

Erro do MySQL 2002: não é possível conectar pelo socket

O cliente tentou o socket Unix local e não encontrou nenhum servidor. O servidor não está em execução, usa outro caminho de socket, ou você queria uma conexão TCP.

Número do erro
2002
Nome
CR_CONNECTION_ERROR
Categoria
Conexão e cliente
Mensagem de erro
Can't connect to local MySQL server through socket '%s' (%d)

O que significa

Quando você se conecta a localhost no Unix, os clientes MySQL usam um arquivo de socket Unix em vez de TCP. 2002 significa que o arquivo de socket não existe ou nada está escutando nele. O número entre colchetes é o erro do sistema operacional, como (2) para arquivo inexistente e (111) para conexão recusada.

Este é um erro do cliente: a requisição nunca chegou a um servidor.

Causas comuns

  • O servidor MySQL não está rodando, ou ele falhou na inicialização.
  • O socket do servidor está em um lugar diferente do que o cliente espera (por exemplo /var/run/mysqld/mysqld.sock versus /tmp/mysql.sock).
  • O servidor está rodando em Docker ou em outra máquina, então não há socket local; você precisa de TCP.
  • Permissões no diretório do socket impedem que o cliente o acesse.

Como corrigir

  1. Verifique se o servidor está em execução e leia seu log de erros se não estiver, por exemplo com systemctl status mysql no Linux ou brew services list no macOS.

  2. Conecte-se via TCP em vez do socket usando 127.0.0.1 em vez de localhost, ou --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. Se o servidor roda localmente, encontre o caminho do socket e aponte o cliente para ele.

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

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.