Menu
Bug e Vulnerabilità

Errore di connessione al database in WordPress: cause e come risolverlo

Gianluca Gentile · · 4 min di lettura

Errore di connessione al database in WordPress: cause e come risolverlo

Il messaggio “Errore nello stabilire una connessione al database” (in inglese “Error establishing a database connection”) è uno degli errori più temuti di WordPress. Il sito diventa completamente inaccessibile, sia per i visitatori che per l’amministratore. In questa guida vediamo tutte le cause possibili e come risolverle.

Cosa significa questo errore

WordPress salva tutti i contenuti — articoli, pagine, impostazioni, utenti — in un database MySQL (o MariaDB). Ogni volta che qualcuno visita una pagina, WordPress si connette al database per recuperare i contenuti. Quando questa connessione fallisce, WordPress non può caricare nulla e mostra l’errore di connessione al database.

L’errore può comparire solo nel frontend (il sito pubblico), solo nella bacheca di amministrazione, oppure su entrambi. Se vedi un messaggio diverso nella bacheca rispetto al frontend, WordPress potrebbe suggerire di riparare il database.

Causa 1: credenziali del database errate in wp-config.php

La causa più comune è che le credenziali di accesso al database nel file wp-config.php non corrispondono a quelle effettive del server. Questo succede spesso dopo una migrazione, un cambio di hosting o una modifica accidentale.

Apri il file wp-config.php nella cartella principale di WordPress e verifica queste quattro righe:

  • DB_NAME — il nome del database.
  • DB_USER — il nome utente del database.
  • DB_PASSWORD — la password dell’utente del database.
  • DB_HOST — l’indirizzo del server database (di solito localhost, ma alcuni hosting usano un indirizzo diverso).

Per verificare, accedi al pannello di controllo del tuo hosting (cPanel, Plesk o simile) e controlla le impostazioni del database MySQL. Se i valori non corrispondono, correggili nel file wp-config.php.

Causa 2: server MySQL non in esecuzione

Se le credenziali sono corrette ma l’errore persiste, il server MySQL potrebbe essere fermo. Questo accade quando il server esaurisce la memoria, quando il processo MySQL va in crash, o dopo un riavvio del server non andato a buon fine.

Se hai accesso SSH al server, puoi verificare lo stato di MySQL con il comando systemctl status mysql (o systemctl status mariadb). Se il servizio è fermo, prova a riavviarlo con systemctl restart mysql. Se non hai accesso SSH, contatta il supporto del tuo hosting.

Su hosting condiviso, il server MySQL è gestito dal provider e un problema sul server database può colpire tutti i siti ospitati. In questi casi bisogna aspettare che il provider risolva il problema.

Causa 3: database corrotto

Un database corrotto può causare l’errore di connessione o comportamenti anomali. La corruzione può avvenire dopo un crash del server, un aggiornamento interrotto o un problema hardware.

WordPress ha una funzionalità integrata per riparare il database. Aggiungi questa riga nel file wp-config.php:

define(‘WP_ALLOW_REPAIR’, true);

Poi visita l’URL tuosito.it/wp-admin/maint/repair.php. Vedrai due opzioni: Ripara database e Ripara e ottimizza database. Scegli la seconda opzione. Importante: dopo la riparazione, rimuovi la riga da wp-config.php perché la pagina di riparazione è accessibile senza autenticazione.

Causa 4: prefisso tabelle errato

Il file wp-config.php contiene anche il prefisso delle tabelle del database (di default wp_). Se questo valore non corrisponde al prefisso effettivo delle tabelle nel database, WordPress non troverà i dati. Questo errore è raro ma può verificarsi dopo una migrazione manuale mal configurata.

Puoi verificare il prefisso reale accedendo a phpMyAdmin e guardando i nomi delle tabelle. Se le tabelle iniziano con wp_ ma nel wp-config.php è impostato un valore diverso, correggilo.

Causa 5: limite di connessioni raggiunto

Ogni server MySQL ha un limite massimo di connessioni simultanee. Se il tuo sito riceve un picco di traffico o se un plugin apre troppe connessioni senza chiuderle, il database potrebbe rifiutare nuove connessioni.

I segnali di questo problema sono: l’errore appare e scompare in modo intermittente, oppure si presenta solo durante le ore di punta. La soluzione è ottimizzare il sito per ridurre le query al database (caching, ottimizzazione plugin) oppure aumentare il limite di connessioni nella configurazione MySQL.

Come prevenire l’errore

  • Backup regolari: se il database si corrompe irreparabilmente, un backup recente è l’unica soluzione.
  • Plugin di caching: un plugin di cache riduce le connessioni al database servendo pagine statiche ai visitatori.
  • Monitoraggio uptime: usa un servizio come UptimeRobot (gratuito) per essere avvisato immediatamente quando il sito va offline.
  • Hosting adeguato: un hosting di qualità monitora MySQL e lo riavvia automaticamente in caso di crash.
  • Non modificare wp-config.php senza backup: prima di qualsiasi modifica, fai una copia del file originale.

Serve aiuto urgente?

L’errore di connessione al database rende il sito completamente inaccessibile e richiede un intervento rapido. Se non riesci a identificare la causa o hai paura di peggiorare la situazione, il team di SoccorsoWP può diagnosticare e risolvere il problema velocemente. Apri un ticket e il tuo sito tornerà online.

Condividi:

Lascia un commento