// Referencia de errores de MySQL

Error de MySQL 2005: host del servidor MySQL desconocido

El cliente no pudo resolver el nombre del host. Revisa la ortografía, el DNS y si el nombre solo se resuelve dentro de una VPN o una red Docker.

Número de error
2005
Nombre
CR_UNKNOWN_HOST
Categoría
Conexión y cliente
Mensaje de error
Unknown MySQL server host '%s' (%d)

Qué significa

Antes de conectar, el cliente busca el nombre del host. 2005 significa que la búsqueda falló, por lo que no se intentó la conexión. El número entre corchetes es el código de error del resolvedor.

Causas comunes

  • Un error tipográfico en el nombre del host, o un esquema o puerto pegados en el campo del host (mysql://db:3306).
  • El nombre solo se resuelve en una red privada o en una VPN a la que no estás conectado.
  • Un nombre de servicio de Docker Compose usado desde fuera de la red de Compose, donde no se resuelve.
  • Problemas de DNS en el equipo cliente.

Cómo solucionarlo

  1. Verifica que el nombre se resuelva desde la máquina cliente, por ejemplo con nslookup db.example.com o ping db.example.com.

  2. Pon solo el nombre del host en el campo del host y el puerto en el campo del puerto.

  3. Desde la máquina anfitriona, se accede al puerto de un contenedor a través de 127.0.0.1 y el puerto publicado, no el nombre del servicio.

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.