Come risolvere l’errore di connessione al database di WordPress

Questa guida è stata aggiornata il 3 Luglio, 2020

Un bel giorno apri il tuo sito, come sei solito fare per verificare che tutto sia a posto. Ma oggi non è affatto tutto a posto. Ciò che ti si presenta davanti, al posto della tua splendida opera d’arte, è una orribile schermata bianca con la scritta “Errore nello stabilire una connessione al database”.

Mettersi a piangere in turco in questa situazione non ti aiuterà affatto, anche se per ora ti sembra l’unica cosa che puoi fare.

In realtà, ci sono ben 4 modi per risolvere questo problema, quindi non c’è bisogno di disperarti!

Calmati e seguimi, te li mostro uno per uno.

4 passi per risolvere l’errore di connessione al database di WordPress

L’errore di connessione al database può dipendere da tanti fattori, come un semplice sovraccarico del server sul quale il tuo sito è ospitato, un errore di codice nel file wp-config di WordPress, o un problema tecnico di altro motivo.

Qualunque cosa sia successa al tuo sito, proveremo a risolverlo in autonomia. Nel peggiore dei casi, potrai comunque contare sul supporto del tuo hosting.

Tanto tempo fa mi successe una cosa del genere. Provai a risolvere da solo, ma non ci riuscii.

Contattai quindi l’assistenza del mio hosting dell’epoca e in effetti il problema non era mio, bensì loro. Nel senso che i server erano sovraccarichi e quindi c’era stato un malfunzionamento.

E questo fu uno dei motivi che mi convinsero a scegliere SiteGround per il mio blog.

Ora però proviamo a risolvere il tuo problema.

1. Ripristina un backup

Hai un backup recente di una versione funzionante del tuo sito?

La cosa più rapida che puoi fare è infatti ripristinarlo. Se il problema dipende da codice presente nei file, è possibile che in questo modo tutto ritorni alla normalità.

Se hai un hosting di qualità, sicuramente avrai anche un servizio di backup automatici quotidiani.

Attenzione però:

1. Ripristinare un backup significa perdere tutte le modifiche che hai effettuato successivamente alla sua data.
2. Non è detto che ripristinando il backup il tuo sito ricominci a funzionare.

Valuta se sia il caso di correre questo rischio.

Se non osi tentare questa strada, allora prova con una delle soluzioni che ti suggerisco qui di seguito.

In ogni caso, esegui un backup prima di procedere.

Sì, anche se in questo momento il sito non funziona, salva ugualmente un backup, non si sa mai!

2. Controlla il file wp-config.php

Il file wp-config.php è uno dei più importanti del tuo intero sito e ci servirà per risolvere l’errore di connessione al database di WordPress.

Un sito WordPress è costituito da file (cioè, file .php, .css. eccetera) e da un database. Se uno di questi due elementi viene a mancare o non è raggiungibile, un sito WordPress non può esistere.

Il file wp-config.php contiene i file necessari a creare il collegamento tra file e database, attraverso le informazioni come il nome del database, e un nome utente e una password per accedere ad esso.

Capirai bene, quindi, che se le credenziali non sono corrette, non è possibile connettersi al database, e quindi si genera l’errore.

Queste credenziali si trovano sotto alla riga/commento:

** Impostazioni MySQL – È possibile ottenere queste informazioni dal proprio fornitore di hosting **

Ci sono tre righe:

• DB_NAME, dove è indicato il nome del database.
• DB_USER, dove è indicato il nome dell’utente associato al database.
• DB_PASSWORD, dove è indicata la password che hai creato per l’utente.

Su un’installazione vera è propria, il file ha questo aspetto (nell’immagine qui sotto le credenziali sono parzialmente oscurate per motivi di sicurezza).

Basta quindi un solo errore in questa sezione del file per impedire a WordPress di raggiungere il database e quindi mostrare il tuo sito.

Vai quindi a verificare che i dati in questo file siano corretti.

Accedi al File Manager dal cPanel, o alla sezione Sito > Gestione Sito del Site Tools se usi SiteGround.

Troverai il file wp-config.php nella cartella public_html, ossia la cartella principale del tuo sito (il suo nome può cambiare a seconda dell’hosting che utilizzi).

Apri il file direttamente nel browser, oppure scaricalo sul tuo PC se per te è più comodo editarlo in questo modo. Assicurati comunque di conservare una copia di backup del file originale.

Trova quindi le righe in cui sono presenti i dati DB_NAME, DB_USER e DB_PASSWORD.

Entra ora nella sezione MySQL del tuo pannello di gestione dello spazio web (quindi in cPanel, Site Tools o comunque l’area clienti del tuo hosting), dove troverai il nome del tuo database e degli utenti ad esso associati.

I dati corrispondono?

Se trovi differenze, correggi il file e salvalo sul server. Tutto ora dovrebbe essere tornato alla normalità.

Se invece i dati corrispondono, allora il problema è un altro.

Proviamo quindi con un altro sistema.

3. Segui la procedura per riparare ed ottimizzare il database del tuo sito

Forse, il database del tuo sito è corrotto e per risolvere l’errore di connessione al database di WordPress dovrai seguire la procedura standard di riparazione.

Torna di nuovo sul file wp-config.php.

Ora, subito dopo l’intestazione

/* Finito, interrompere le modifiche! Buon blogging. */

aggiungi la riga:

define(‘WP_ALLOW_REPAIR’, true);

Qui sotto vedi uno screenshot del file con l’aggiunta di questo codice:

Questa riga di codice serve ad attivare la funzionalità di riparazione, anche quando non hai accesso al sito e devi quindi lavorare su di esso dall’esterno.

Quando hai aggiunto il codice e salvato il file, visita questo URL (ovviamente, sostituendo www.example.com con il dominio del tuo sito):

www.example.com/wp-admin/maint/repair.php

Qui vedrai alcune istruzioni con due opzioni:

• Riparazione database, solo per identificare errori e ripararli.

• Riparazione ed ottimizzazione del database, per individuare e risolvere eventuali problemi, ed ottimizzare il database. Questa opzione potrebbe essere la migliore però richiede più tempo. Per far sì che il tuo sito torni a funzionare, non è necessario ottimizzare il database.

Selezionando la prima opzione, al termine della riparazione vedrai questa schermata:

Come vedi, alla fine è suggerito di rimuovere i codici che hai precedentemente aggiunto al file wp-config.php.

Infatti, per avviare la procedura di riparazione del database non è necessario inserire alcuna credenziale. Questo significa che chiunque potrebbe farlo!

Evita quindi che questo “chiunque” approfitti della situazione ed elimina la riga define(‘WP_ALLOW_REPAIR’, true); per disattivare la funzionalità e mantenere il tuo sito sicuro.

Ancora non sei riuscito a risolvere il problema?

Allora è il caso di rivolgersi al supporto tecnico.

4. Contatta il tuo hosting provider

Se non sei riuscito a risolvere l’errore di connessione al database di WordPress, contatta il tuo hosting provider.

Come ti spiegavo all’inizio, se non hai fatto alcuna modifica su WordPress, sui file o sul database, ed il tuo sito improvvisamente non funziona, potrebbe esserci un problema di sovraccarico del server.

In questo caso, alcuni utenti forse riescono a vedere il sito. Altri probabilmente vedono una schermata bianca. Altri ancora forse vedono l’errore di connessione al database.

Se usi un servizio di tipo condiviso, un sovraccarico del server potrebbe non essere necessariamente dovuto a un picco di traffico sul tuo sito.

Infatti, anche un picco di traffico su un altro dei siti che condividono con te il server può determinare problemi anche su tutti gli altri siti qui presenti.

Contattare il tuo hosting provider è quindi la prima cosa da fare per verificare se l’errore di connessione è causato da fattori che non dipendono da un tuo errore o dal tuo sito, e procedere nella maniera ottimale per risolvere l’errore di connessione al database di WordPress.

Nella maggior parte dei casi, l’operatore del team di supporto tecnico sarà anche in grado di fornirti informazioni aggiuntive sul tipo di errore riscontrato e su come risolverlo.

In ogni caso, se non hai abbastanza confidenza con la gestione di file o manipolazione di codici, contatta l’assistenza dell’hosting per capire cosa possa aver causato il problema di connessione al database.

Sapranno sicuramente indirizzarti verso la soluzione nella maniera più semplice e rapida possibile.

Conclusione

In questa guida abbiamo visto come risolvere l’errore di connessione al database di WordPress.

Se vedi questo errore, cerca di mantenere la calma. Nella maggior parte dei casi è risolvibile senza ripercussioni sul tuo sito o sui suoi contenuti.

Segui quindi le istruzioni sopra per individuare il problema; dovresti riuscire a rendere il tuo sito nuovamente visibile in poco tempo.

Come al solito, ora passo a te la parola:

Ti è mai capitato di vedere sul tuo sito un errore di connessione al database?

Come lo hai risolto?

Ti sei rivolto al servizio di supporto del tuo hosting provider oppure hai adottato una delle soluzioni descritte sopra?

Ti invito a farmelo sapere lasciando un commento qui sotto al post.