MySQL Error 2003: cannot connect to server

In breve: MySQL Error 2003 cannot connect — indica che il client non riesce ad aprire una connessione TCP al server MySQL.

Cosa indica il problema

MySQL Error 2003 cannot connect — indica che il client non riesce ad aprire una connessione TCP al server MySQL. La diagnosi deve collegare la prova, l’orario e il primo evento utile nei log prima di cambiare la configurazione.

Sintomi e cause probabili

Sintomi da verificare

• Il comportamento descritto da “MySQL Error 2003: cannot connect to server” si ripete nella stessa operazione
• Il controllo di query, schema e log del database produce un dato coerente con lo stesso orario
• Un tentativo comparabile permette di capire se l’anomalia è generale o limitata a un solo elemento

Cause probabili

• Il client non raggiunge host e porta del server MySQL
• Servizio non in ascolto su socket o porta previsti
• Host o socket configurati in modo errato
• Firewall o rete che interrompe la sessione

Controlli da eseguire

1. Verifica DNS, porta, bind-address, firewall e stato del servizio
2. Verificare stato servizio e porte in ascolto
3. Provare connessione locale e remota separatamente
4. Controllare host, porta e socket dell’applicazione
5. Leggere log MySQL e sistema nello stesso orario

Dati utili

• Log MySQL o MariaDB
• PhpMyAdmin o client SQL
• Error_log dell’applicazione chiamante

Correzione sicura

1. Ripristina raggiungibilità e ascolto senza esporre MySQL pubblicamente
2. Avviare e configurare il servizio sull’endpoint corretto
3. Correggere host, porta o socket
4. Allineare firewall e rete
5. Ottimizzare query e timeout in modo mirato

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 1008: cannot drop database
• MySQL Error 2005: unknown MySQL server host
• MySQL Error 1005: Cannot create table

Fonti tecniche

• MySQL 8.4 Reference Manual
• MariaDB Documentation

Domande frequenti