Automatia
Cerca
Contatti

«Si è verificato un errore critico»: come rimettere in piedi WordPress

Per chi ha il sito WordPress fermo: cosa vuol dire l'errore critico di WordPress, come trovare il plugin o il tema che lo causa e rimettere online il sito.

Team Automatia · pubblicata il · 10 minuti di lettura

Documento di esempio: l'email che avvisa dell'errore critico di WordPress, con il plugin che l'ha causato e il link alla modalità di recupero.
L'email dice quale componente ha fermato il sito: lo disattivi in modalità di recupero.

In breve. L'errore critico di WordPress di solito viene da un plugin, dal tema o dalla versione di PHP. Cerca l'email con il link alla modalità di recupero; se non arriva, rinomina dall'hosting la cartella dell'ultimo plugin aggiornato e leggi l'errore nel file debug.log.

Se vuoi che ce ne occupiamo noi. Lo risolviamo noi, veloce e in sicurezza. Scrivici su WhatsApp o chiama il +39 375 669 3055: siamo operativi 24 ore su 24, 7 giorni su 7. Prezzo fisso, detto prima di cominciare; per i piccoli interventi una cifra piccola. Come funziona: pronto intervento.

Quando WordPress non funziona e al posto del sito compare «Si è verificato un errore critico sul tuo sito web», il codice PHP si è fermato con un errore fatale. L'errore ferma la pagina, non cancella i contenuti, che restano nel database: va trovato il pezzo che si è rotto.

La riga «PHP Fatal error» nomina la cartella del plugin che ferma il sito; l'avviso «PHP Warning», sopra, non c'entra. Dati di esempio.

Errore critico di WordPress: cosa dice il messaggio

Dalla versione 5.2 WordPress intercetta gli errori fatali: al posto della pagina vuota mostra un avviso, che cambia secondo dove compare (codice di WordPress):

  • sul sito pubblico: «Si è verificato un errore critico sul tuo sito web.»;
  • nella bacheca e nella pagina di accesso: «Si è verificato un errore critico in questo sito. Controlla le email in arrivo nella casella di posta dell'amministratore del sito per le istruzioni.»;
  • in modalità di recupero, l'avviso rimanda alle schermate dei temi e dei plugin.

In tutti e tre i casi la pagina risponde con il codice HTTP 500: per il browser è un errore 500 di WordPress. Su versioni vecchie, o con la gestione degli errori spenta, di solito compare invece una schermata bianca.

Dal messaggio al punto in cui intervenire. I testi sono quelli di WordPress in italiano.
Cosa vediCosa vuol direDove si interviene
«Si è verificato un errore critico…»Plugin, tema o versione di PHP hanno fermato il codiceEmail di WordPress, cartella dei plugin, debug.log
Schermata biancaLo stesso guasto senza avviso, o la memoria finitadebug.log, registro degli errori dell'hosting
«Errore nello stabilire una connessione al database»WordPress non raggiunge il databasewp-config.php, pannello dell'hosting
«Momentaneamente non disponibile per manutenzione»Un aggiornamento non si è chiusoFile .maintenance
«Non hai il permesso di accedere a questa pagina.»Il tuo utente non può aprire quella schermataRuolo dell'utente, plugin disattivati
«Aggiornamento fallito. La risposta non è una risposta JSON valida.»L'editor non riceve la risposta attesa dall'API RESTSalute del sito, cache, firewall
Pagina «500 Internal Server Error» del serverGuasto prima di WordPress, per esempio nel file .htaccess.htaccess, registro degli errori

Per l'ultima riga c'è la guida sul sito non raggiungibile o in errore 500; per la documentazione di WordPress sugli errori comuni la causa più probabile è un file .htaccess danneggiato.

Cosa fare da soli per rimettere online il sito

Prima di toccare i file, scarica una copia di quello che modifichi o fai un backup dal pannello dell'hosting: rinominare una cartella si annulla in un attimo, cancellarla no.

  1. Cerca l'email di WordPress

    Ha per oggetto «Il tuo sito [nome del sito] ha un problema tecnico», arriva all'indirizzo email di amministrazione e dice quale plugin o tema ha causato l'errore.

  2. Entra in modalità di recupero

    Dal link dell'email accedi alla bacheca, dove il componente in errore è sospeso: dalla schermata dei plugin o dei temi lo disattivi, poi esci dalla modalità di recupero dalla barra in alto.

  3. Disattiva il plugin dall'hosting

    Senza email, apri con l'FTP o con il file manager del pannello la cartella wp-content/plugins e rinomina quella dell'ultimo plugin aggiornato, per esempio aggiungendo -off. Se non sai quale, rinomina l'intera cartella plugins, entra nella bacheca, ridalle il nome originale e riattiva i plugin uno alla volta, come indica la guida di WordPress.

  4. Prova un tema predefinito

    Se l'errore resta, rinomina in wp-content/themes la cartella del tema attivo e apri Aspetto > Temi: WordPress torna a un tema predefinito, se ce n'è uno installato. Se il tema non c'entra, ridai il nome alla cartella e riattivalo da Aspetto > Temi.

  5. Leggi l'errore

    Se la causa non salta fuori, accendi il registro degli errori, come nella sezione che segue.

La sospensione della modalità di recupero vale solo per te: chi visita il sito vede l'errore finché il componente non è disattivato (nota tecnica di WordPress 5.2).

Schermata bianca: leggere l'errore nel file debug.log

Senza email né avviso utile, la causa si legge nel registro degli errori. Si accende in wp-config.php, nella cartella principale del sito, con tre righe sopra il commento che chiude le impostazioni da modificare (documentazione sul debug):

  • «define( 'WP_DEBUG', true );» accende la modalità di debug;
  • «define( 'WP_DEBUG_LOG', true );» scrive errori e avvisi nel file wp-content/debug.log;
  • «define( 'WP_DEBUG_DISPLAY', false );» evita di mostrarli ai visitatori.

Ricarica la pagina che dà errore e apri debug.log: cerca la riga «PHP Fatal error» con l'ora del guasto. Il percorso dice chi è stato: dopo wp-content/plugins/ c'è la cartella del plugin, dopo wp-content/themes/ quella del tema.

Salute del sito segnala il registro come un rischio, perché è un file potenzialmente accessibile a tutti (documentazione): trovata la causa, togli le tre righe e cancella debug.log.

Due casi hanno una soluzione nota:

  • «Allowed memory size of … bytes exhausted»: è finita la memoria. WordPress chiede a PHP 40 MB su un sito singolo; il limite si alza con WP_MEMORY_LIMIT in wp-config.php, fin dove l'hosting lo permette (documentazione di wp-config.php);
  • «Call to undefined function» dopo un cambio di PHP: il plugin o il tema usa una funzione che la versione nuova non ha più, come create_function, eliminata in PHP 8.0 (php.net). Se il pannello dell'hosting lo permette, torna alla versione precedente di PHP solo finché non aggiorni o sostituisci il componente.

La versione di PHP in uso è nel pannello dell'hosting o in Strumenti > Salute del sito, scheda Informazioni.

«Errore nello stabilire una connessione al database»

WordPress non riesce a parlare con il database, dove stanno pagine, utenti e impostazioni. Le cause indicate dalla documentazione: dati di accesso sbagliati in wp-config.php, un problema dell'hosting, come il server del database fermo o lo spazio esaurito, oppure un sito violato.

  1. Confronta in wp-config.php i valori di DB_NAME, DB_USER, DB_PASSWORD e DB_HOST con quelli del pannello dell'hosting. DB_HOST di solito è localhost, ma non sempre (guida all'installazione). Se hai cambiato la password del database dal pannello, va cambiata anche lì.
  2. Se i dati sono giusti, guarda nel pannello lo stato e lo spazio del database. Se insieme al sito non rispondono la posta o gli altri siti sullo stesso hosting, è più probabile un disservizio del fornitore: controlla la sua pagina di stato o chiedi alla sua assistenza.
  3. Se WordPress segnala tabelle da riparare, fai prima un backup del database e poi usa la riparazione delle tabelle di phpMyAdmin, come indica la guida di WordPress.

La costante WP_ALLOW_REPAIR apre invece la pagina di riparazione wp-admin/maint/repair.php anche a chi non ha accesso: va tolta appena finito (wp-config.php).

Aggiornamento fallito e sito fermo in manutenzione

Mentre si aggiorna, WordPress mette nella cartella principale un file .maintenance e mostra «Momentaneamente non disponibile per manutenzione. Riprova fra un minuto.», l'avviso di manutenzione programmata (in inglese «Briefly unavailable for scheduled maintenance»). Di norma WordPress considera finita la manutenzione dopo 10 minuti (wp_is_maintenance_mode); se l'avviso resta, cancella il file .maintenance e rifai l'aggiornamento, che può essersi fermato a metà.

Se invece l'aggiornamento è finito e il sito si è rotto, la prima indiziata è l'ultima cosa aggiornata. Per un plugin della directory di wordpress.org, la versione precedente si scarica dalla sua pagina avanzata, alla voce Previous Versions; wordpress.org avverte che le versioni vecchie possono essere insicure, quindi servono solo in attesa di una correzione. Per WordPress stesso, quando l'aggiornamento automatico non si chiude, la documentazione indica l'aggiornamento manuale, dopo un backup di cui hai verificato il contenuto.

Non riesco ad accedere a WordPress: password e permessi

Se il problema è la password, il link «Password dimenticata?» nella pagina di accesso manda un'email per sceglierne una nuova. Se l'email non arriva, la password si cambia anche senza: da phpMyAdmin, scrivendo la nuova password nel campo user_pass della tabella degli utenti con la funzione MD5, oppure con WP-CLI, se l'hosting lo offre (guida di WordPress). phpMyAdmin modifica il database direttamente: prima fai un backup.

Quando wp-admin non funziona per altri motivi, guarda cosa compare:

  • «Non hai il permesso di accedere a questa pagina.» vuol dire che il tuo utente non può aprire quella schermata: il suo ruolo non lo consente, oppure la schermata non esiste più, come quella di un plugin disattivato (codice di WordPress);
  • se la pagina di accesso rimanda da un indirizzo all'altro senza aprirsi, vedi i troppi reindirizzamenti nella guida sul sito non raggiungibile.

Se tra gli utenti trovi amministratori che non conosci, o il tuo utente non è più amministratore, trattalo come un'intrusione: cambia le password e segui la guida sul sito hackerato.

WordPress non salva: «La risposta non è una risposta JSON valida»

L'editor a blocchi salva pagine e articoli attraverso l'API REST di WordPress, che risponde in JSON (manuale dell'API REST). Il messaggio vuol dire che al posto di quella risposta è arrivato altro, per esempio una pagina d'errore o il blocco di un firewall. Si controlla in quest'ordine:

  1. in Strumenti > Salute del sito c'è un controllo sull'API REST, che WordPress fa perché le misure di sicurezza possono bloccarla (test di Salute del sito);
  2. svuota la cache del plugin, dell'hosting e dell'eventuale CDN, poi riprova;
  3. se l'indirizzo del sito seguito da /wp-json/ risponde con un errore 404, il manuale dell'API REST rimanda ai permalink: salvali di nuovo in Impostazioni > Permalink, che rigenera le regole del file .htaccess;
  4. prova senza i plugin di sicurezza e di cache: con il plugin Health Check & Troubleshooting, pubblicato da WordPress.org, la prova vale solo per il tuo utente. Con un firewall o una CDN davanti al sito, cerca nei loro registri le richieste bloccate verso /wp-json/.
Per il vostro tecnicoWP-CLI, modalità di recupero, debug, manutenzione

WP-CLI. «wp plugin list --status=active» elenca i plugin attivi, «wp plugin deactivate nome-plugin» ne spegne uno, con --all tutti; «wp user update 1 --user_pass=… --skip-email» cambia una password senza email (comandi WP-CLI). Da phpMyAdmin i plugin si spengono tutti con a:0:{} nell'opzione active_plugins.

Modalità di recupero. Gli endpoint protetti sono bacheca, wp-login.php e alcune azioni AJAX (is_protected_endpoint); i plugin attivati a livello di rete sono esclusi. Il link vale quanto l'intervallo tra due email; RECOVERY_MODE_EMAIL cambia destinatario, WP_DISABLE_FATAL_ERROR_HANDLER spegne il meccanismo.

Debug e manutenzione. WP_DEBUG_LOG accetta anche un percorso, meglio fuori dalla cartella pubblica. Il file .maintenance tiene in $upgrading l'ora di creazione; in manutenzione WordPress risponde 503 con Retry-After: 600, e un file wp-content/maintenance.php sostituisce il messaggio (wp_maintenance).

Come evitare che si ripeta

Molti di questi guasti arrivano dopo un aggiornamento, un cambio di PHP o un plugin in più. Si prevengono con poche abitudini:

  • aggiornamenti provati prima in un ambiente di prova e fatti uno alla volta, così si capisce subito quale ha rotto il sito;
  • un backup di file e database prima di ogni aggiornamento, verificato davvero, come chiede la documentazione (aggiornare WordPress);
  • PHP in una versione che riceve ancora correzioni di sicurezza, dopo aver controllato che tema e plugin la supportino;
  • pochi plugin, e plugin inattivi e temi inutilizzati tolti, come suggerisce Salute del sito;
  • l'indirizzo email di amministrazione su una casella letta ogni giorno, perché è lì che arrivano l'avviso dell'errore e il link di recupero;
  • un controllo esterno che apre il sito ogni pochi minuti e avvisa se risponde con un errore.

Sono controlli che possono entrare nell'assistenza e manutenzione. Se il sito deve fare di più che mostrare pagine, nella pagina dei siti web aziendali c'è il confronto tra WordPress, costruttori online e sviluppo su misura.

Quando chiamarci e cosa facciamo

Conviene chiamarci se non hai gli accessi all'hosting, se l'errore viene da un componente che non puoi spegnere, come il tema del sito o il plugin del negozio online, o se torna dopo ogni correzione. Ci servono:

  • Gli accessi. Al pannello dell'hosting, con FTP, SSH o file manager, e un utente amministratore di WordPress: meglio un utente dedicato, da togliere alla fine, e mai password per email.
  • Cosa è cambiato. L'ultimo aggiornamento, un plugin nuovo o un cambio di PHP, con l'ora del primo errore.
  • L'email di WordPress. Se è arrivata, inoltrala: dice quale componente si è fermato.

Troviamo il componente in errore, che sia un plugin, il tema, la versione di PHP o la memoria, e rimettiamo online il sito, se serve da un backup, anche quando l'ha costruito un altro fornitore. Poi aggiorniamo nucleo, tema e plugin prima in un ambiente di prova e solo dopo sul sito.

Nei casi comuni il sito torna online in poche ore; l'aggiornamento completo di un sito rimasto indietro di solito chiede uno o due giorni, secondo i plugin. Rispondiamo subito: siamo operativi 24 ore su 24, 7 giorni su 7. Il prezzo è fisso e te lo diciamo prima di cominciare; per i piccoli interventi è una cifra piccola. Ti seguiamo finché è risolto, e poi c'è l'assistenza. I dettagli sono nella pagina del pronto intervento.

Domande frequenti

Non arriva l'email della modalità di recupero: cosa faccio?

WordPress la manda solo se l'errore viene da un plugin o da un tema e si presenta nella bacheca o nella pagina di accesso, e al massimo una volta al giorno (codice della modalità di recupero). Apri quindi la pagina di accesso, poi guarda nello spam e controlla l'indirizzo email di amministrazione, in Impostazioni > Generali. Se il server del sito non spedisce posta, l'email non partirà: rinomina dall'hosting la cartella del plugin sospetto, e per le email del sito vedi la guida sulle email in spam.

Disattivando un plugin perdo le impostazioni?

Di norma no. Rinominare la cartella dei plugin, spiega la guida di WordPress, conserva le impostazioni: i plugin vanno solo riattivati. Il manuale per chi sviluppa prevede che opzioni e tabelle si cancellino alla disinstallazione, cioè quando elimini il plugin, non alla disattivazione (metodi di disinstallazione). Per questo, in emergenza, si disattiva o si rinomina, non si elimina.

Quale versione di PHP serve a WordPress?

WordPress consiglia PHP 8.3 o successivo. Funziona ancora con PHP 7.4 e seguenti, ma la stessa pagina dei requisiti avverte che le versioni vecchie possono esporre il sito a vulnerabilità. Fino a quando ogni versione riceve correzioni lo dice php.net: la 8.2, per esempio, solo quelle di sicurezza e fino al 31 dicembre 2026. Prima di cambiare, controlla che tema e plugin supportino la versione nuova.

Perché WordPress non carica le immagini?

Il messaggio di errore indica il caso: file oltre la dimensione massima ammessa dal server, formato non consentito («Non hai i permessi per caricare questo tipo di file.») o cartella uploads non scrivibile. Dimensione massima e permessi delle cartelle si leggono in Strumenti > Salute del sito, scheda Informazioni (documentazione); a una cartella non si danno mai i permessi 777 (permessi dei file). Se invece le immagini sono nella libreria ma non si vedono sul sito in https, possono essere contenuti misti, indirizzi in http che il browser corregge o blocca (MDN): vedi la guida sul certificato SSL.

Conviene attivare gli aggiornamenti automatici di WordPress?

Per le versioni minori di WordPress sono già attivi di serie (wp-config.php), e conviene lasciarli: servono a ricevere gli aggiornamenti di sicurezza. Per plugin e temi si attivano uno per uno dalla versione 5.5 e partono due volte al giorno (guida di WordPress); dalla 6.6, se l'aggiornamento automatico di un plugin manda in errore fatale la home page, WordPress torna alla versione precedente (annuncio della 6.6 e nota tecnica). Conviene attivarli con un backup automatico ogni giorno; i plugin da cui dipende il lavoro, come quello del negozio online, meglio aggiornarli a mano dopo una prova.

Hai un'altra domanda? Scrivici · +39 375 669 3055

WordPress è ancora fermo

Mandaci l'indirizzo del sito, l'ora del primo errore e cosa è cambiato prima: ti diciamo cosa serve e il prezzo, fisso, prima di cominciare.

Società
Automatia S.r.l.Gestionali su misura, automazioni, integrazioni tra sistemi.
Operativi
24 ore su 24, 7 giorni su 7
Lingue
Italiano, inglese o russo
Scrivici
  1. Ci scrivi
  2. Prima valutazione
  3. Breve chiamata
Scrivici su WhatsApp, al +39 375 669 3055 (si apre in una nuova scheda)