// MySQL-Fehlerreferenz

MySQL-Fehler 2003: Verbindung zum MySQL-Server auf Host nicht möglich

Der Client konnte keine TCP-Verbindung zu Host und Port öffnen. Der Server läuft nicht, lauscht woanders, oder eine Firewall steht dazwischen.

Fehlernummer
2003
Name
CR_CONN_HOST_ERROR
Kategorie
Verbindung und Client
Fehlermeldung
Can't connect to MySQL server on '%s:%u' (%d)

Was es bedeutet

2003 wird vom Client ausgelöst, wenn die TCP-Verbindung selbst fehlschlägt. Die Zahl in Klammern ist der Betriebssystemfehler: (111) oder (10061) unter Windows bedeutet Verbindung abgelehnt (nichts lauscht), (110) oder (10060) bedeutet Zeitüberschreitung (normalerweise verwirft eine Firewall Pakete), und (113) bedeutet keine Route zum Host.

Der Server hat die Anmeldung nie gesehen, daher spielen Passwort und Berechtigungen noch keine Rolle.

Häufige Ursachen

  • Der Server läuft nicht oder lauscht auf einem anderen Port als 3306.
  • Der Server lauscht nur auf 127.0.0.1 (bind_address), daher werden entfernte Verbindungen abgelehnt.
  • Eine Firewall, Sicherheitsgruppe oder Cloud-Netzwerkregel blockiert Port 3306.
  • Falscher Hostname oder falsche IP-Adresse in den Verbindungseinstellungen.

Wie du es behebst

  1. Prüfe auf dem Server, ob MySQL läuft und auf welcher Adresse und welchem Port es lauscht.

    SHOW VARIABLES WHERE Variable_name IN ('bind_address', 'port', 'skip_networking');
  2. Um entfernte Verbindungen zuzulassen, setze bind_address = 0.0.0.0 (oder die eigene IP des Servers) in der [mysqld] Abschnitt der Konfigurationsdatei und starte MySQL neu. Stell sicher, dass ein Konto für den Remote-Host existiert.

  3. Öffne den Port in der Firewall des Servers und in jeder Cloud-Sicherheitsgruppe und teste dann vom Client-Rechner aus, zum Beispiel mit nc -vz db.example.com 3306.

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.