ERROR 2006 (HY000): MySQL server has gone away

So sieht die Meldung aus

ERROR 2006 (HY000): MySQL server has gone away
PHP Warning: mysqli::query(): MySQL server has gone away in /var/www/app/db.php on line 42

Häufige Ursachen

• Die Verbindung war länger als wait_timeout untätig, der Server hat sie geschlossen, und die App hat die tote Verbindung weiterverwendet, typisch für lang laufende Skripte und Worker.
• Eine Abfrage oder Zeile ist größer als max_allowed_packet, z. B. bei einem großen Import oder einem Blob.
• Der Server ist abgestürzt oder wurde neu gestartet, oft vom OOM-Killer beendet, daher sind alle Verbindungen weg.
• Eine Firewall, ein Load Balancer oder ein Proxy trennt untätige Verbindungen früher als die Datenbank.
• Die Verbindung wurde mit KILL beendet oder der Server hat ein anderes Limit erreicht.

Prüfen

1. Leerlauf-Timeout
   mysql -e "SHOW VARIABLES LIKE 'wait_timeout'"Kopieren
2. Maximale Paketgröße
   mysql -e "SHOW VARIABLES LIKE 'max_allowed_packet'"Kopieren
3. Gab es einen Neustart? Laufzeit in Sekunden
   mysql -e "SHOW GLOBAL STATUS LIKE 'Uptime'"Kopieren
4. Absturz, Kill oder Neustart im Log
   journalctl -u mariadb -u mysql --since '1 day ago' --no-pager | grep -iE 'killed|out of memory|ready for connections|shutdown' | tail -n 20Kopieren

Lösung

• Ist Uptime klein oder zeigt das Log einen Kill, wurde der Server neu gestartet. Erst klären, warum (Speicher, Absturz). Der Fehler ist nur die Folge.
• Bei untätigen Verbindungen: Die App bei diesem Fehler neu verbinden lassen oder die Verbindung vor der Nutzung prüfen (Ping). Pools sollten Verbindungen früher als wait_timeout erneuern.
• Bei großen Abfragen und Importen das Limit am Server anheben, z. B. max_allowed_packet = 64M in [mysqld], und auch am Client (mysql --max-allowed-packet oder die Einstellung von mysqldump). Der Wert ist ein Beispiel, richte ihn nach deinen Daten.
• Das Leerlauf-Timeout von Firewall oder Proxy mit wait_timeout abstimmen oder Keepalives senden.
• wait_timeout nicht einfach sehr hoch setzen. Das staut untätige Verbindungen an und führt zu Too many connections.

Häufige Fragen

Warum passiert es nur nach einer langen Pause?

Der Server hat die untätige Verbindung nach wait_timeout geschlossen, und die App hat sie danach benutzt. Die Lösung liegt beim Client: neu verbinden oder erneuern.

Es passiert nur bei großen Importen.

Dann ist das Paket größer als max_allowed_packet. Hebe es an Server und Client an oder teile den Import in kleinere Anweisungen.