"Error establishing a database connection": il sito sparisce, ma la causa è quasi sempre identificabile
È uno degli errori più allarmanti: visiti il tuo sito e al posto delle pagine trovi solo la scritta "Error establishing a database connection" (errore nello stabilire una connessione al database). Tutto il sito è inaccessibile, frontend e spesso anche l'area di amministrazione. È comprensibile preoccuparsi, perché sembra che il sito sia sparito. Ma la causa è quasi sempre identificabile e risolvibile: WordPress non riesce a comunicare con il database (dove sono memorizzati tutti i contenuti), e questo dipende tipicamente da credenziali errate, dal server del database non raggiungibile, o da un database danneggiato o sovraccarico. Capire quale di queste è la causa permette di risolvere e riportare il sito online. I contenuti, nel database, restano: è un problema di connessione, non di perdita.
Le cause principali e come affrontarle
Credenziali del database errate
WordPress si connette al database usando delle credenziali (nome del database, utente, password, host) memorizzate nel file di configurazione wp-config. Se una di queste è errata o è cambiata, la connessione fallisce. Questo accade spesso dopo: una migrazione del sito (le credenziali del nuovo server sono diverse), un cambio di password del database, o un intervento sulla configurazione. La soluzione: verificare che le credenziali nel wp-config corrispondano esattamente a quelle del database (controllabili nel pannello dell'hosting). Un solo carattere sbagliato nella password o nel nome impedisce la connessione. Correggere le credenziali ripristina la connessione. Importante: fare un backup del wp-config prima di modificarlo.
Server del database non raggiungibile o sovraccarico
A volte le credenziali sono giuste, ma il server del database (MySQL) non risponde: può essere temporaneamente non disponibile (un problema dell'hosting), sovraccarico (troppo traffico o query pesanti che lo saturano), o il servizio MySQL è fermo. In questi casi, l'errore non dipende dalla tua configurazione ma dallo stato del server. Se le credenziali sono corrette e l'errore persiste, conviene verificare con l'hosting lo stato del database. Su hosting condivisi, un sovraccarico (anche di altri siti) può causare temporaneamente questo errore. Un database sovraccarico per troppe query inefficienti o troppo traffico va affrontato ottimizzando il sito o potenziando le risorse.
Diagnosticare e risolvere con metodo
Per risolvere, procedi con ordine. Primo, verifica se il problema è solo tuo o generale (a volte è un disservizio temporaneo dell'hosting che si risolve da sé): attendi qualche minuto e ricontrolla. Se persiste: verifica le credenziali nel wp-config confrontandole con quelle del database nel pannello hosting (causa più comune dopo migrazioni o cambi password). Se le credenziali sono corrette, verifica con l'hosting lo stato del server del database (potrebbe essere down o sovraccarico). In alcuni casi, il database può essere danneggiato (corrotto): WordPress ha una funzione di riparazione del database attivabile, e l'hosting può assistere nel ripristino. Fai sempre un backup prima di interventi sul database o sulla configurazione. Per prevenire: mantieni il sito ottimizzato (un database efficiente è meno soggetto a sovraccarichi) e backup regolari. LANGA Tools aiuta a mantenere il sito ottimizzato e con backup automatici.
Domande frequenti
Ho perso tutti i contenuti del sito?
Quasi certamente no. L'errore di connessione al database significa che WordPress non riesce a comunicare con il database, non che il database (e i suoi contenuti) sia sparito. I tuoi contenuti, articoli, pagine, e impostazioni sono memorizzati nel database e, una volta ripristinata la connessione (correggendo le credenziali o risolvendo il problema del server), tornano accessibili. Solo in rari casi di database gravemente danneggiato i dati possono essere a rischio, ed è qui che i backup regolari sono fondamentali (permettono di ripristinare). Nella stragrande maggioranza dei casi, è un problema di connessione temporaneo o di configurazione, e i contenuti sono al sicuro nel database.
L'errore è comparso dopo una migrazione: perché?
È un caso molto comune. Quando sposti un sito WordPress su un nuovo server o hosting, le credenziali del database del nuovo ambiente (nome, utente, password, host) sono diverse da quelle del vecchio. Se il file wp-config contiene ancora le vecchie credenziali, WordPress prova a connettersi con dati sbagliati e fallisce, mostrando l'errore. La soluzione: aggiornare le credenziali nel wp-config con quelle del nuovo database (reperibili nel pannello del nuovo hosting). Anche l'host del database a volte cambia (non sempre è "localhost"). Verificare e correggere le credenziali per il nuovo ambiente risolve l'errore tipico post-migrazione. È uno dei passaggi standard da controllare quando si sposta un sito.
Per continuare a leggere,
accedi al tuo account.
Il tuo account LANGA ti connette a tutta la Galaxy.
Articoli completi su tutti i blog Galaxy.
Un solo login, accesso ovunque.
Guadagna Leghe e sblocca contenuti premium.