In breve: MySQL Error 2002 Connection refused — indica che il client raggiunge l’host ma nessun servizio MySQL accetta la connessione su socket o porta indicati.
Indice dei contenuti
MySQL Error 2002 Connection refused: significato
Le prime ipotesi da verificare per “MySQL Error 2002 Connection refused” sono servizio non in ascolto su socket o porta previsti; host o socket configurati in modo errato.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “MySQL Error 2002 Connection refused” compare durante un’operazione ripetibile.
- La funzione coinvolta in MySQL e MariaDB non raggiunge il risultato previsto.
- Il log dell’area MySQL e MariaDB registra un evento nello stesso minuto della prova.
- Il comportamento osservato in MySQL e MariaDB cambia in base a utente, rete, file o configurazione.
Cause probabili
- Servizio non in ascolto su socket o porta previsti
- Host o socket configurati in modo errato
- Firewall o rete che interrompe la sessione
- Timeout superato da una query lunga
Diagnosi passo per passo
- Verificare stato servizio e porte in ascolto
- Provare connessione locale e remota separatamente
- Controllare host, porta e socket dell’applicazione
- Leggere log MySQL e sistema nello stesso orario
- Misurare durata e dimensione della query
Log e dati da controllare
- log MySQL o MariaDB
- phpMyAdmin o client SQL
- error_log dell’applicazione chiamante
Correzioni sicure
- Avviare e configurare il servizio sull’endpoint corretto
- Correggere host, porta o socket
- Allineare firewall e rete
- Ottimizzare query e timeout in modo mirato
- Risolvere la pressione di risorse prima di aumentare i limiti
Verifica finale
- La query termina con il risultato previsto
- Schema e vincoli restano coerenti
- Non compaiono nuovi warning o lock
- L’applicazione legge e scrive i dati correttamente
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- MySQL Error 2013: Lost connection during query
- MySQL Error 1129: Host is blocked per troppi errori di connessione
- MySQL Error 2026: SSL connection error
Fonti tecniche
Domande frequenti
Che cosa significa “MySQL Error 2002 Connection refused”?
MySQL Error 2002 Connection refused — indica che il client raggiunge l’host ma nessun servizio MySQL accetta la connessione su socket o porta indicati.
Da cosa può dipendere “MySQL Error 2002 Connection refused”?
Le cause da verificare per “MySQL Error 2002 Connection refused” sono: servizio non in ascolto su socket o porta previsti; host o socket configurati in modo errato; firewall o rete che interrompe la sessione.
Quali controlli eseguire per “MySQL Error 2002 Connection refused”?
Per diagnosticare “MySQL Error 2002 Connection refused”, controlla nell’ordine: verificare stato servizio e porte in ascolto; provare connessione locale e remota separatamente; controllare host, porta e socket dell’applicazione. La soluzione è confermata quando la query termina con il risultato previsto; schema e vincoli restano coerenti.