// MySQL-Fehlerreferenz

MySQL-Fehler 2005: Unbekannter MySQL-Server-Host

Der Client konnte den Hostnamen nicht zu einer Adresse auflösen. Prüfe die Schreibweise, DNS und ob der Name nur innerhalb eines VPN oder Docker-Netzwerks auflöst.

Fehlernummer
2005
Name
CR_UNKNOWN_HOST
Kategorie
Verbindung und Client
Fehlermeldung
Unknown MySQL server host '%s' (%d)

Was es bedeutet

Bevor eine Verbindung hergestellt wird, löst der Client den Hostnamen auf. 2005 bedeutet, dass die Suche fehlgeschlagen ist, daher wurde keine Verbindung versucht. Die Zahl in Klammern ist der Fehlercode des Resolvers.

Häufige Ursachen

  • Ein Tippfehler im Hostnamen oder ein Schema bzw. Port, der in das Host-Feld eingefügt wurde (mysql://db:3306).
  • Der Name löst sich nur in einem privaten Netzwerk oder VPN auf, mit dem du nicht verbunden bist.
  • Ein Docker-Compose-Dienstname, der von außerhalb des Compose-Netzwerks verwendet wird, wo er nicht aufgelöst wird.
  • DNS-Probleme auf dem Clientrechner.

Wie du es behebst

  1. Prüfe, ob sich der Name vom Client-Rechner aus auflösen lässt, zum Beispiel mit nslookup db.example.com oder ping db.example.com.

  2. Trage nur den Hostnamen ins Host-Feld und den Port ins Port-Feld ein.

  3. Vom Host aus erreichst du den Port eines Containers über 127.0.0.1 und den veröffentlichten Port, nicht den Servicenamen, erreicht.

Zugehörige Fehler

Weitere Verbindungs- und Clientfehler

Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit MySQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für MySQL und die anderen Datenbanken, mit denen du arbeitest.