// Referencia de errores de MySQL

Error de MySQL 2003: no se puede conectar al servidor MySQL en el host

El cliente no pudo abrir una conexión TCP con ese host y puerto. El servidor está caído, escucha en otro lugar o hay un firewall de por medio.

Número de error
2003
Nombre
CR_CONN_HOST_ERROR
Categoría
Conexión y cliente
Mensaje de error
Can't connect to MySQL server on '%s:%u' (%d)

Qué significa

El 2003 es generado por el cliente cuando la conexión TCP en sí falla. El número entre corchetes es el error del sistema operativo: (111) o (10061) en Windows significa conexión rechazada (no hay nada escuchando), (110) o (10060) significa tiempo de espera agotado (normalmente un firewall que descarta paquetes), y (113) significa que no hay ruta al host.

El servidor nunca vio el inicio de sesión, por lo que la contraseña y los permisos aún no importan.

Causas comunes

  • El servidor no está en ejecución, o escucha en un puerto distinto del 3306.
  • El servidor solo escucha en 127.0.0.1 (bind_address), así que se rechazan las conexiones remotas.
  • Un firewall, grupo de seguridad o regla de red en la nube bloquea el puerto 3306.
  • Nombre de host o dirección IP incorrectos en los ajustes de conexión.

Cómo solucionarlo

  1. En el servidor, verifica que MySQL esté en ejecución y en qué dirección y puerto escucha.

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. Para aceptar conexiones remotas, establece bind_address = 0.0.0.0 (o la propia IP del servidor) en el [mysqld] sección del archivo de configuración y reinicia MySQL. Asegúrate de que exista una cuenta para el host remoto.

  3. Abre el puerto en el firewall del servidor y en cualquier grupo de seguridad de la nube, luego prueba desde la máquina cliente, por ejemplo con nc -vz db.example.com 3306.

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.