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.socke/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
- Il servizio è attivo?
systemctl status mariadb - Perché si è fermato? Leggi le ultime righe del log
- Il socket esiste?
ls -l /run/mysqld/ - C'è spazio libero per la directory dei dati?
df -h /var/lib/mysql
Soluzione
- Avvia il servizio e leggi perché era fermo:
systemctl start mariadb. Su MySQL l'unità si chiamamysql. - Libera spazio o ripristina i permessi su
/var/lib/mysqlse 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.1e la porta 3306 invece dilocalhostper collegarti via TCP.
Scenario tipico
Hai spostato un'applicazione PHP in un container Docker mentre il database resta sull'host. La configurazione dice ancora DB_HOST=localhost e la pagina mostra l'errore 2002 con il percorso /var/run/mysqld/mysqld.sock. Dentro il container quel file socket non esiste, perché sta nel filesystem dell'host. Verifica per prima cosa se il client gira sullo stesso sistema del server e passa l'host a un indirizzo IP.
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.
Perché l'errore compare subito dopo un riavvio, anche se prima funzionava tutto?
Il file socket di solito sta in /run, una directory volatile, e viene creato solo all'avvio del server. Se il servizio non parte dopo il boot, per esempio perché un disco non è ancora montato o è pieno, il socket non esiste e arriva l'errore 2002.
I miei dati sono persi quando compare l'errore 2002?
No. L'errore dice solo che al percorso atteso nessun server risponde. I dati stanno nella directory dei dati, di solito /var/lib/mysql, e sono intatti. Controlla lì spazio e permessi prima di cancellare o reinizializzare qualcosa.
Come scopro quale percorso del socket si aspetta il mio client?
Il client da riga di comando lo mostra con mysql --help | grep -i socket. In PHP decidono mysqli.default_socket e pdo_mysql.default_socket. Il server usa il valore socket della sezione [mysqld]; i due devono coincidere.