Come risolvere l’errore di connessione al database di WordPress

Questa guida è stata aggiornata il 11 Gennaio, 2020

Provi a visitare il tuo sito e tutto ciò che vedi è una schermata bianca con la scritta “Errore nello stabilire una connessione al database”?

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

Prima di iniziare… hai un backup del tuo sito? Il tuo hosting provider offre backup automatici? Sei in grado di generarne uno ora, anche se il tuo sito non è raggiungibile? Prima di fare modifiche al database e/o ai file, ti consiglio di scaricare una copia del backup più recente disponibile per il tuo sito.

1) Contatta il tuo hosting provider

La prima cosa da fare per risolvere l’errore di connessione al database di WordPress è contattare il tuo hosting provider. Soprattutto se usi uno spazio server condiviso e/o se non hai pratica nel lavorare direttamente sui database e sui file WordPress.

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. Altri ancora forse vedono l’errore di connessione al database.

Se usi un servizio di tipo shared, un sovraccarico del server potrebbe non essere necessariamente dovuto a un picco di traffico sul tuo sito. Piuttosto, ad un picco di traffico su un altro dei siti che condividono con te il server.

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.

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 serve a creare il collegamento tra file e database.

Al suo interno ci sono diverse informazioni, tra cui – appunto – nome del database e credenziali per accedervi.

Queste informazioni 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).

Anche se solo una di queste informazioni non è corretta, gli utenti vedranno un errore di connessione al database.

Apri quindi il file wp-config.php e verifica che le credenziali siano quelle giuste.

Puoi aprire il file direttamente dal File Manager che trovi all’interno del cPanel (prima di modificarlo, ti consiglio comunque di scaricarlo così da avere una copia di backup) oppure via FTP (in questo caso, puoi scaricarlo, modificarlo con un editore di testo e caricarlo nuovamente).

Le credenziali relative al database si trovano all’interno del cPanel, in MySQL Databases. Qui trovi i nomi dei database creati sul tuo account con gli utenti associati.

Se le informazioni relative al database ed all’utente associato sono corrette ma il tuo sito continua a non funzionare, passa allo step successivo per risolvere l’errore di connessione al database di WordPress.

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.

Per prima cosa, naviga all’interno del File Manager è trova il file wp-config.php.

Scarica il file per avere una copia di backup. Quindi, aprilo in modalità di modifica.

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. Per avviare la procedura di riparazione del database non è necessario inserire alcuna credenziale. Questo significa che chiunque potrebbe farlo! Rimuovere i codici define(‘WP_ALLOW_REPAIR’, true); è quindi essenziale per disattivare la funzionalità e mantenere il tuo sito sicuro.

Se dopo aver fatto tutte queste cose il sito ancora non funziona, considera la possibilità di ripristinare l’ultimo backup salvato.

In ogni caso, ti consiglio comunque di lavorare con il tuo hosting provider per capire cosa ha causato l’errore di connessione al database. Se non è stato un errore da parte tua, oppure l’aggiornamento o l’installazione di un plugin, potrebbe trattarsi di un problema con un aggiornamento automatico o con la configurazione del server.

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.