// Referencia de errores de MySQL

Error de MySQL 2002: no se puede conectar a través del socket

El cliente intentó el socket Unix local y no encontró ningún servidor allí. El servidor no está en ejecución, usa otra ruta de socket, o querías una conexión TCP.

Número de error
2002
Nombre
CR_CONNECTION_ERROR
Categoría
Conexión y cliente
Mensaje de error
Can't connect to local MySQL server through socket '%s' (%d)

Qué significa

Cuando te conectas a localhost en Unix, los clientes de MySQL usan un archivo de socket de Unix en lugar de TCP. 2002 significa que el archivo de socket no existe o que no hay nada escuchando en él. El número entre corchetes es el error del sistema operativo, como (2) para archivo inexistente y (111) para conexión rechazada.

Es un error del cliente: la solicitud nunca llegó a ningún servidor.

Causas comunes

  • El servidor MySQL no está en ejecución, o falló al arrancar.
  • El socket del servidor está en un lugar diferente al que espera el cliente (por ejemplo /var/run/mysqld/mysqld.sock versus /tmp/mysql.sock).
  • El servidor se ejecuta en Docker o en otra máquina, por lo que no hay socket local; necesitas TCP.
  • Los permisos del directorio del socket impiden que el cliente llegue a él.

Cómo solucionarlo

  1. Verifica que el servidor esté en funcionamiento y lee su registro de errores si no lo está, por ejemplo con systemctl status mysql en Linux o brew services list en macOS.

  2. Conéctate a través de TCP en lugar del socket usando 127.0.0.1 en lugar de localhost, o --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. Si el servidor corre en local, busca la ruta de su socket y apunta el cliente hacia ella.

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

Errores relacionados

Más errores de conexión y de cliente

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con MySQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para MySQL y las demás bases de datos que uses.