Errore nello stabilire una connessione al database in WordPress: cause e soluzioni

Errore nello stabilire una connessione al database in WordPress: cause e soluzioni

Il messaggio “Errore nello stabilire una connessione al database” indica che WordPress non riesce a comunicare correttamente con il database MySQL o MariaDB utilizzato dal sito.

Il problema può dipendere da credenziali errate, da un utente non associato al database, da tabelle danneggiate, da un servizio temporaneamente non disponibile oppure da un precedente trasferimento o cambio di password.

Prima di modificare file o database, crea un backup quando possibile.

1. Verifica se il problema riguarda soltanto il sito

Controlla se:

• cPanel è raggiungibile;
• altri siti presenti sullo stesso account funzionano;
• l’errore interessa sia il sito sia la bacheca WordPress;
• sono presenti manutenzioni o anomalie nella pagina Stato Server;
• il problema è comparso dopo una migrazione, un ripristino o una modifica della password del database.

Se anche altri servizi risultano irraggiungibili, attendi alcuni minuti oppure contatta l’assistenza prima di modificare la configurazione del sito.

2. Controlla il file wp-config.php

Accedi a Gestione file di cPanel e apri la cartella nella quale è installato WordPress.

Individua il file:

wp-config.php

Prima di modificarlo, scaricane una copia di sicurezza.

Controlla queste quattro impostazioni:

define( 'DB_NAME', 'nome_database' );
define( 'DB_USER', 'nome_utente_database' );
define( 'DB_PASSWORD', 'password_database' );
define( 'DB_HOST', 'localhost' );

Verifica che:

• DB_NAME corrisponda esattamente al nome del database;
• DB_USER corrisponda all’utente associato;
• DB_PASSWORD contenga la password corrente;
• DB_HOST utilizzi il valore corretto per il server.

WordPress utilizza queste costanti per stabilire la connessione. Il valore di DB_HOST è spesso localhost, ma può essere diverso in alcune configurazioni: non modificarlo senza una conferma.

Non pubblicare né inviare le credenziali contenute nel file.

3. Verifica database, utente e privilegi in cPanel

Da cPanel apri:

Database → Gestisci i miei database

Il nome della funzione può essere visualizzato anche come Database MySQL nelle versioni precedenti.

Controlla che:

• il database indicato in DB_NAME esista;
• l’utente indicato in DB_USER esista;
• l’utente sia associato al database corretto;
• l’utente disponga dei privilegi necessari.

Se l’utente non è associato:

1. seleziona l’utente;
2. seleziona il database;
3. clicca su Aggiungi;
4. assegna i privilegi richiesti;
5. salva le modifiche.

cPanel permette di creare e gestire database, utenti e privilegi dalla stessa interfaccia.

4. Controlla la password del database

L’errore può comparire dopo aver cambiato la password dell’utente MySQL senza aggiornare anche il file wp-config.php.

Se imposti una nuova password da cPanel, devi inserire esattamente la stessa password in:

define( 'DB_PASSWORD', 'nuova_password' );

Fai attenzione a:

• lettere maiuscole e minuscole;
• caratteri speciali;
• spazi copiati accidentalmente;
• virgolette mancanti o modificate.

Salva il file e ricarica il sito.

5. Controlla e ripara il database

Se credenziali e privilegi sono corretti, il database potrebbe contenere una o più tabelle danneggiate.

Da cPanel apri:

Database → Gestisci i miei database

Seleziona il database e utilizza, quando disponibili:

• Controlla database;
• Ripara database.

Esegui la riparazione soltanto sul database utilizzato dal sito interessato.

cPanel mette a disposizione funzioni specifiche per controllare e riparare i database gestiti dall’account.

6. Controlla lo spazio disponibile

Se lo spazio dell’account è completamente esaurito, il database o altri servizi potrebbero non riuscire a scrivere nuovi dati correttamente.

Controlla in cPanel:

• spazio disco utilizzato;
• dimensione del database;
• caselle email particolarmente grandi;
• backup archiviati nell’account;
• file temporanei o registri molto pesanti.

Non eliminare file o database senza averne prima verificato la funzione.

7. Verifica migrazioni e ripristini recenti

Dopo una migrazione o il ripristino di un backup, controlla che:

• il database sia stato importato;
• il nome del database sia corretto;
• l’utente sia stato ricreato;
• l’utente sia associato al database;
• la password coincida con quella presente nel file wp-config.php;
• il prefisso delle tabelle sia quello corretto.

Il prefisso delle tabelle viene definito nel file con una riga simile a:

$table_prefix = 'wp_';

Non cambiarlo a meno che il database utilizzi realmente un prefisso differente.

8. Non reinstallare WordPress

Non reinstallare WordPress e non creare un nuovo database prima di aver controllato credenziali, utente, privilegi e database esistente.

Una reinstallazione non risolve una configurazione errata e può complicare il recupero del sito.

9. Ripristina un backup

Se il problema è iniziato dopo una modifica al database, una migrazione o un aggiornamento, puoi ripristinare una copia precedente funzionante.

Prima del ripristino verifica:

• la data del backup;
• quali file e database verranno sostituiti;
• se sono presenti ordini, commenti o modifiche recenti da conservare.

10. Contatta l’assistenza

Se l’errore continua, apri un ticket indicando:

• dominio interessato;
• data e ora della comparsa;
• eventuale migrazione o ripristino effettuato;
• modifiche recenti alla password del database;
• nome del database e dell’utente, senza comunicare la password;
• risultato del controllo o della riparazione;
• eventuali altri servizi non raggiungibili.

Queste informazioni permettono al supporto di verificare più rapidamente il servizio database e la configurazione dell’account.