// MySQL-Fehlerreferenz

MySQL-Fehler 2026: SSL-Verbindungsfehler

Der TLS-Handshake zwischen Client und MySQL-Server ist fehlgeschlagen: ein Zertifikat, dem der Client nicht vertraut, nicht übereinstimmende TLS-Versionen oder SSL erforderlich, aber deaktiviert.

Fehlernummer
2026
Name
CR_SSL_CONNECTION_ERROR
Kategorie
Verbindung und Client
Fehlermeldung
SSL connection error: %s

Was es bedeutet

Der Client und der Server konnten keine verschlüsselte Verbindung herstellen. Der Text nach SSL connection error: ist der Grund der TLS-Bibliothek, zum Beispiel eine fehlgeschlagene Zertifikatsprüfung oder keine gemeinsame Protokollversion, und genau der Teil, den du lesen solltest.

Häufige Ursachen

  • Der Client überprüft das Serverzertifikat (--ssl-mode=VERIFY_CA oder VERIFY_IDENTITY) und das Zertifikat ist selbstsigniert oder der Hostname stimmt nicht überein.
  • Der Client ist so konfiguriert, dass TLS erforderlich ist, und der Server hat es deaktiviert.
  • Ein alter Client oder Server unterstützt nur TLS-Versionen, die auf der anderen Seite deaktiviert wurden.
  • Falsche Pfade oder Berechtigungen für die CA-, Zertifikat- oder Schlüsseldateien.

Wie du es behebst

  1. Prüfe, was der Server anbietet.

    SHOW VARIABLES LIKE '%ssl%';
    SHOW VARIABLES LIKE 'tls_version';
  2. Gib dem Client das CA-Zertifikat, das das Serverzertifikat signiert hat, zum Beispiel mysql --ssl-mode=VERIFY_CA --ssl-ca=ca.pem -h db.example.com -u app -p.

  3. Wenn beide Seiten alt sind, bring die Client-Bibliothek auf den neuesten Stand, statt alte TLS-Versionen auf dem Server wieder zu erlauben.

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.