Il sito è morto. Al posto delle pagine leggi solo «Errore nello stabilire una connessione con il database» e WordPress non ti dice niente di più. Non è cattiveria: è una scelta di sicurezza. Se ti dicesse “password sbagliata” o “MySQL è crashato“, darebbe a un attaccante la mappa del tuo server.
Quindi tocca a te fare il lavoro. Buona notizia: l’errore connessione database WordPress si chiude nella maggior parte dei casi in meno di dieci minuti, senza toccare una riga di codice. Cattiva notizia: se vai a tentoni perdi mezza giornata. Qui sotto trovi l’ordine esatto dei controlli, dal sospetto più probabile al meno probabile.
Perché WordPress non riesce a connettersi al database
WordPress non ha un database suo. Si appoggia a un server MySQL o MariaDB, che di solito gira sulla stessa macchina dell’hosting, ma può stare anche altrove. Le credenziali per entrare in quel server sono scritte in chiaro dentro wp-config.php, il file nella cartella principale dell’installazione.
Se una di quelle quattro costanti — nome database, utente, password, host — non combacia con quello che MySQL si aspetta, la connessione cade. Punto. È il caso più banale e anche il più frequente.
Poi ci sono gli scenari meno simpatici: il server MySQL è crashato, hai esaurito le connessioni simultanee consentite dal tuo piano, il provider ha cambiato l’host del database senza avvisarti, oppure una tabella si è corrotta dopo un aggiornamento andato storto.
wp-config.php: qui si gioca l’80% delle partite
Apri il file via FTP o dal file manager dell’hosting e controlla riga per riga queste definizioni:
- DB_NAME — il nome esatto del database, non quello che ricordi
- DB_USER — spesso NON è uguale al nome del database, anche se molti hosting li fanno coincidere
- DB_PASSWORD — se contiene caratteri come $, ‘ o ” la cosa si complica
- DB_HOST — il campo dove quasi tutti sbagliano
Sul DB_HOST apri una parentesi seria: localhost funziona nella maggioranza dei casi, ma su alcuni pannelli (cPanel con database su server separato, hosting gestiti, ambienti Docker) devi usare 127.0.0.1 oppure un hostname interno tipo mysql.tuohosting.com. Se il database ascolta su una porta non standard, va indicata: localhost:3307.
Un errore che vedo spesso dopo una migrazione: il prefisso delle tabelle. Il sito nuovo ha tabelle xyz_ ma wp-config punta al vecchio wp_. La connessione al server riesce, ma WordPress non trova nulla e ti butta fuori lo stesso. È una delle cause più insidiose dell’errore connessione database WordPress e nessuno la controlla mai.
La password con caratteri speciali
Se la password contiene apici singoli o doppi, va scritta con l’escape corretto oppure cambiata direttamente dal pannello hosting. Non è un dettaglio da nerd: è una causa reale e sottovalutata.
Il database è vivo? Verificalo in trenta secondi
Entra in phpMyAdmin dal pannello del provider e prova ad accedere con gli stessi dati del wp-config. Se entri senza problemi, il server è su e le credenziali pure: il problema è da un’altra parte.
Se phpMyAdmin ti risponde con un errore di connessione, hai la risposta che cercavi: il guasto è lato server. In quel caso non c’è niente che tu possa fare da WordPress, devi aprire un ticket all’hosting.
Se hai accesso SSH, WP-CLI ti dà una mano vera: wp db check e wp db repair fanno in due secondi quello che a mano richiede dieci minuti di clic.
Le tabelle corrotte e la riparazione da dentro WordPress
WordPress ha una modalità di riparazione nascosta che quasi nessuno conosce. Aggiungi questa riga al wp-config.php:
define( ‘WP_ALLOW_REPAIR’, true );
Poi apri tuosito.it/wp-admin/maint/repair.php. Ti compariranno due pulsanti: uno ripara le tabelle, l’altro le ripara e le ottimizza. Funziona bene sull’errore connessione database WordPress causato da una tabella danneggiata dopo un crash.
Rimuovi subito quella riga dopo l’uso. Quella pagina è accessibile a chiunque senza login, e se la lasci lì stai regalando la riparazione del database al primo bot che passa.
Plugin e tema: il secondo sospetto
A volte il database risponde, ma è un plugin a mandare in tilt la connessione: query enormi, loop infiniti, connessioni mai chiuse. Il test è brutale e veloce: rinomina via FTP la cartella wp-content/plugins in plugins-off.
Se il sito torna online, hai trovato il colpevole. Riattiva i plugin uno alla volta fino a quando si ripresenta l’errore. Con temi e plugin pesanti sulle tabelle wp_options, questo scenario è più comune di quanto si pensi.
Rinominare wp-config.php: la mossa che funziona
Se hai escluso tutto il resto, rinomina il file wp-config.php in wp-config-old.php. Ricarica il sito: WordPress capirà che manca la configurazione e ti mostrerà la procedura guidata, chiedendoti nome database, utente, password e host.
Inserisci i dati e lui ricrea un wp-config.php nuovo di zecca, pulito, senza righe fantasma o caratteri corrotti. È il metodo più sottovalutato per chiudere un errore connessione database WordPress dopo un trasferimento di hosting.
Attenzione al prefisso: nella procedura guidata ti verrà chiesto il prefisso delle tabelle. Se lo sbagli ti ritrovi un’installazione vuota collegata a tabelle che non esistono. Copialo da phpMyAdmin prima di iniziare.
Casi che nessuna guida ti racconta
Connessioni esaurite. Molti piani condivisi limitano le connessioni simultanee. Un picco di bot, un crawler aggressivo o un attacco e il database smette di accettare nuovi collegamenti. Sembra un guasto, in realtà è traffico.
MySQL 8 e autenticazione. Le nuove versioni usano caching_sha2_password, che le vecchie build PHP non sanno gestire. La soluzione è chiedere all’hosting un utente con mysql_native_password. È un caso raro ma reale, e ti fa perdere ore se non lo conosci.
Firewall. Se il database è su un server remoto, l’IP del tuo sito deve essere autorizzato. Dopo un cambio di infrastruttura lato hosting, quell’autorizzazione sparisce e il sito muore senza preavviso.
Spazio disco pieno. MySQL rifiuta nuove scritture e la connessione salta. Controlla la quota prima di impazzire sulle credenziali.
Quando è ora di chiamare l’hosting
Se phpMyAdmin non si apre, se il servizio MySQL risulta in stato down dal pannello, se il ticket è l’unico strumento che ti resta — non perdere altro tempo. Scrivi all’assistenza indicando l’ora esatta dell’errore, il messaggio completo e cosa hai già provato. L’errore connessione database WordPress in quel caso non è colpa tua e non è risolvibile dal tuo lato.
Una cosa però falla sempre, prima di qualsiasi intervento: scarica un backup del database. Se la riparazione peggiora le cose, quello è il tuo unico paracadute.
