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
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.sockversus/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
-
Verifica que el servidor esté en funcionamiento y lee su registro de errores si no lo está, por ejemplo con
systemctl status mysqlen Linux obrew services listen macOS. -
Conéctate a través de TCP en lugar del socket usando
127.0.0.1en lugar delocalhost, o--protocol=TCP.mysql -h 127.0.0.1 -P 3306 -u app -p
-
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
2003No se puede conectar al servidor MySQL en el host2005Host del servidor MySQL desconocido2013Se perdió la conexión con el servidor MySQL durante la consulta53SQL Server: Relacionado con la red o específico de la instancia08006PostgreSQL: fallo de conexión
Más errores de conexión y de cliente
2006El servidor MySQL se ha ido2055Se perdió la conexión con el servidor MySQL en la etapa2026Error de conexión SSL2059No se puede cargar el complemento de autenticación2061El complemento de autenticación informó un error1251El cliente no admite el protocolo de autenticación3159Transporte inseguro prohibido1158Error al leer paquetes de comunicación
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.
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.