Errori di WordPress: i più comuni e come risolverli

WordPress è un sistema solido, ma è fatto di molti pezzi che devono andare d’accordo: il core, il tema, decine di plugin, la versione di PHP, il database e la configurazione del server. Quando uno di questi pezzi smette di collaborare, il sito può mostrare una pagina bianca, un messaggio di errore critico o semplicemente rifiutarsi di caricare le immagini. La buona notizia è che la stragrande maggioranza degli errori di WordPress ha poche cause ricorrenti e si risolve con un metodo, senza bisogno di essere sviluppatori.

Questa guida raccoglie gli errori più comuni, spiega da cosa nascono e propone una procedura di diagnosi che puoi applicare anche a problemi che non trovi elencati qui. Se non sei sicuro che il problema dipenda da WordPress, parti dalla nostra panoramica sugli errori del sito web.

Prima regola: fai un backup e non lavorare alla cieca

Prima di toccare file o database, assicurati di avere una copia recente del sito. Molti hosting offrono backup automatici ripristinabili dal pannello; se non li hai, scarica almeno i file via FTP e un’esportazione del database. Poi attiva la registrazione degli errori: è l’unico modo per sapere che cosa sta succedendo invece di indovinarlo.

Per farlo, apri il file wp-config.php nella cartella principale del sito e, prima della riga che dice di smettere di modificare il file, inserisci queste impostazioni:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

In questo modo gli errori vengono scritti nel file wp-content/debug.log senza essere mostrati ai visitatori. Quando hai finito, rimetti WP_DEBUG a false: lasciare il debug attivo su un sito in produzione è inutile e può esporre informazioni sensibili.

Errore critico e pagina bianca

Dalla versione 5.2, quando un errore fatale di PHP blocca il sito, WordPress mostra il messaggio Si è verificato un errore critico in questo sito web e invia all’email dell’amministratore un link per accedere in modalità di recupero. Nelle versioni precedenti, o quando l’email non arriva, lo stesso problema si presenta come una pagina completamente bianca.

Le cause sono quasi sempre tre: un plugin o un tema appena aggiornato che non è compatibile con il resto, una versione di PHP troppo vecchia o troppo nuova per il codice installato, oppure il superamento del limite di memoria. Il file debug.log indica di solito con precisione il file e la riga che hanno causato l’errore, e il percorso del file rivela quale plugin è il colpevole.

Se non riesci ad accedere alla bacheca, puoi disattivare tutti i plugin rinominando via FTP o file manager la cartella wp-content/plugins, per esempio in plugins-off. Se il sito torna a funzionare, rimetti il nome originale e riattiva i plugin uno alla volta finché l’errore non si ripresenta. Lo stesso principio vale per il tema: rinominando la cartella del tema attivo, WordPress ripiega su un tema predefinito, se è installato.

Errore nello stabilire una connessione al database

Questo messaggio significa che WordPress non riesce a parlare con MySQL o MariaDB. Le cause, in ordine di frequenza, sono credenziali errate in wp-config.php dopo una migrazione o un cambio di password, un server database sovraccarico o temporaneamente spento, e tabelle danneggiate. Controlla che nome del database, utente, password e host coincidano con quelli indicati nel pannello dell’hosting; se le credenziali sono corrette e l’errore è intermittente, il problema è quasi certamente lato server e va segnalato all’hosting.

Errore 404 sugli articoli

Se la home page funziona ma ogni articolo restituisce una pagina non trovata, il problema è nei permalink. Succede spesso dopo una migrazione o quando il file .htaccess viene sovrascritto. Nella maggior parte dei casi basta andare in Impostazioni → Permalink e salvare senza modificare nulla: WordPress rigenera le regole di riscrittura. Se l’errore persiste, verifica che il file .htaccess esista e contenga il blocco standard di WordPress e che il server abbia il modulo di riscrittura attivo.

Errori di memoria e di tempo di esecuzione

Messaggi come Allowed memory size exhausted o Maximum execution time exceeded indicano che uno script ha chiesto più memoria o più tempo di quanto il server conceda. Accade spesso con page builder pesanti, importazioni di grandi dimensioni o plugin di backup. Puoi alzare il limite di memoria di WordPress aggiungendo a wp-config.php la riga define( 'WP_MEMORY_LIMIT', '256M' );, ma il valore effettivo non potrà superare quello impostato da PHP sul server. Se il limite dell’hosting è troppo basso, va aumentato dal pannello o chiedendo all’assistenza.

Problemi con il caricamento di file e immagini

Gli errori legati alla libreria media sono tra i più frustranti. Il file caricato supera la direttiva upload_max_filesize dipende dai limiti di PHP, che si modificano dal pannello dell’hosting o tramite il file di configurazione di PHP. Il generico Errore HTTP durante il caricamento di un’immagine nasce spesso da memoria insufficiente per l’elaborazione o da immagini con dimensioni enormi. Non hai i permessi per caricare questo tipo di file significa invece che WordPress blocca quel formato per ragioni di sicurezza: è il caso tipico dei file SVG, che vanno abilitati con un plugin che li sanifichi.

Se le immagini caricate non compaiono, il problema può essere nei permessi della cartella wp-content/uploads, che deve essere scrivibile dal server: di norma 755 per le cartelle e 644 per i file.

Aggiornamenti falliti e sito bloccato in manutenzione

Durante un aggiornamento WordPress crea un file chiamato .maintenance nella cartella principale e mostra il messaggio Momentaneamente non disponibile per manutenzione programmata. Se l’aggiornamento si interrompe, il file resta lì e il sito rimane bloccato. La soluzione è eliminarlo via FTP o file manager e poi ripetere l’aggiornamento non riuscito. Se un aggiornamento fallisce ripetutamente, le cause tipiche sono permessi dei file errati, spazio su disco esaurito o un timeout del server.

Problemi di accesso alla bacheca

Se dopo il login torni sempre alla pagina di accesso, se compare I cookie sono bloccati o non supportati dal browser o se il messaggio è Non hai i permessi sufficienti per accedere a questa pagina, la causa può essere nei cookie del browser, in un indirizzo del sito impostato in modo incoerente (con e senza www, oppure con http invece di https), in un plugin di sicurezza o in un ruolo utente danneggiato. Il primo tentativo è sempre svuotare i cookie del sito; se hai perso la password e l’email di recupero non arriva, puoi reimpostarla direttamente dal database tramite phpMyAdmin.

Modifiche che non si vedono

Hai aggiornato una pagina ma il sito mostra ancora la versione vecchia? Quasi sempre è colpa di una cache: quella del browser, quella di un plugin come LiteSpeed Cache o WP Rocket, quella del server o di un CDN. Svuotale in quest’ordine, dalla più vicina al visitatore alla più vicina al server, e il problema sparisce.

Errori dopo una migrazione

Spostare un sito WordPress su un nuovo hosting o su un nuovo dominio è il momento in cui si concentrano più errori, perché cambiano contemporaneamente server, database e indirizzi. I problemi tipici sono tre. Il primo è l’errore di connessione al database, dovuto a credenziali non aggiornate in wp-config.php. Il secondo sono le pagine che reindirizzano al vecchio dominio o restituiscono 404, perché gli indirizzi del sito salvati nel database, nelle opzioni siteurl e home, non sono stati aggiornati, oppure perché i permalink vanno rigenerati. Il terzo sono immagini e link interni rotti, che puntano ancora al vecchio indirizzo dentro il contenuto degli articoli.

Per quest’ultimo caso non basta una sostituzione di testo diretta nel database: WordPress e molti plugin salvano dati in un formato serializzato, in cui la lunghezza delle stringhe è registrata insieme al testo, e una sostituzione manuale lo corrompe. Servono strumenti che gestiscano la serializzazione, come il comando wp search-replace di WP-CLI o i plugin di migrazione dedicati. Fai sempre un backup del database prima di eseguirli.

Il metodo che risolve anche gli errori che non conosci

Qualunque sia il messaggio, la procedura per isolare la causa è sempre la stessa. Leggi il log degli errori per avere un indizio concreto: la guida ai log del server spiega dove trovarlo e come interpretarlo. Ripensa a che cosa è cambiato prima che il problema comparisse: un aggiornamento, un nuovo plugin, una modifica dell’hosting. Disattiva i plugin per escludere conflitti, poi passa a un tema predefinito. Verifica la versione di PHP e i limiti di risorse. Se nulla di tutto questo funziona, ripristina il backup più recente e contatta l’hosting con le righe del log che hai raccolto: renderai il loro lavoro molto più rapido.

Se il blocco non riguarda WordPress ma il server stesso, con codici come 500, 502 o 503, trovi il significato di ciascuno nella guida ai codici di stato HTTP; se invece il sito non si apre affatto e il browser mostra sigle come ERR_CONNECTION_REFUSED, parti dalla guida agli errori del browser.

Domande frequenti

Posso risolvere un errore critico senza accedere alla bacheca?

Sì. Puoi usare il link di modalità di recupero inviato all’email dell’amministratore oppure disattivare i plugin rinominando la loro cartella via FTP o file manager. Entrambe le strade non richiedono l’accesso alla bacheca.

È sicuro disattivare tutti i plugin?

Disattivarli non cancella le loro impostazioni, che restano nel database. Il sito può però perdere temporaneamente alcune funzioni, come moduli di contatto o sistemi di cache, quindi è meglio farlo in un momento di traffico basso o su una copia di staging.

Quale versione di PHP devo usare?

Quella più recente supportata sia da WordPress sia dai plugin che usi. Le versioni non più supportate non ricevono aggiornamenti di sicurezza; prima di cambiare versione, però, verifica la compatibilità su una copia del sito.