MySQL / MariaDB: ERROR 2002 (HY000), connessione tramite socket impossibile

Come appare il messaggio

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)

Cause frequenti

• Il servizio del database non è in esecuzione: fermato, andato in crash o terminato dall'OOM killer.
• Il server non è partito perché il disco è pieno o la directory dei dati è danneggiata o ha permessi errati.
• Client e server usano percorsi del socket diversi, ad esempio /run/mysqld/mysqld.sock e /var/lib/mysql/mysql.sock.
• L'applicazione si collega a localhost, cioè al socket, mentre il server ascolta solo su TCP.
• Una seconda istanza o un container usa un altro socket.

Verifica

1. Il servizio è attivo?
   systemctl status mariadbCopia
2. Perché si è fermato? Leggi le ultime righe del log
   journalctl -u mariadb --since '1 hour ago' --no-pager | tail -n 30Copia
3. Il socket esiste?
   ls -l /run/mysqld/Copia
4. C'è spazio libero per la directory dei dati?
   df -h /var/lib/mysqlCopia

Soluzione

• Avvia il servizio e leggi perché era fermo: systemctl start mariadb. Su MySQL l'unità si chiama mysql.
• Libera spazio o ripristina i permessi su /var/lib/mysql se era questo il motivo.
• Se l'ha fermato l'OOM killer, riduci l'uso di memoria (innodb_buffer_pool_size) o aggiungi RAM.
• Usa lo stesso percorso del socket nelle sezioni [client] e [mysqld] della configurazione.
• Nell'applicazione usa 127.0.0.1 e la porta 3306 invece di localhost per collegarti via TCP.

Domande frequenti

Che differenza c'è qui tra localhost e 127.0.0.1?

Con localhost il client MySQL usa il file socket Unix. Con 127.0.0.1 usa TCP. Se il socket manca ma TCP funziona, questo spiega l'errore.

Che errore compare con la password sbagliata?

È ERROR 1045. L'errore 2002 viene prima: il client non raggiunge nemmeno il server.