«Massimiliano, il sito è bianco. C’è scritto che si è verificato un errore critico. Ho perso tutto?»

Me lo chiedono quasi sempre con queste parole, e quasi sempre la risposta è no: non hai perso niente. Contenuti, prodotti, ordini e clienti sono dove li hai lasciati, nel database. Quello che si è rotto è il codice che li tira fuori e li mostra. Sembra una distinzione accademica mentre guardi una pagina bianca, ma cambia l’ordine delle cose da fare: non si corre a ripristinare, si cerca prima chi ha rotto.

Cos’è, in concreto, un errore critico

Dalla versione 5.2 WordPress non ti lascia più davanti a una schermata bianca e muta. Quando una parte del codice si ferma con un errore fatale di PHP — un plugin che chiama una funzione che non esiste più, un tema che si aspetta un’altra versione di PHP, uno snippet nel functions.php con una parentesi di troppo — WordPress intercetta il blocco, interrompe il caricamento e scrive quella riga: «Si è verificato un errore critico sul tuo sito web».

Nello stesso momento fa un’altra cosa che quasi nessuno guarda: manda una mail all’amministratore, con il file che ha causato il problema, la riga esatta e un link alla modalità ripristino, che apre la bacheca con il plugin colpevole già disattivato. In buona parte dei casi che mi arrivano la soluzione era lì, in una mail finita nello spam o su un indirizzo che nessuno legge più.

L’ordine in cui si interviene

Il sito è offline e ogni minuto sembra costare qualcosa. Proprio per questo l’ordine conta più della velocità: ogni passo che salti è una variabile in più da escludere dopo.

  1. La mail di ripristino. Cerca nella casella dell’amministratore «WordPress» e «errore critico», spam compreso. Se c’è, hai già il nome del colpevole e un accesso alla bacheca.
  2. I log. Se la mail non è arrivata, si attiva WP_DEBUG_LOG nel wp-config.php e si legge wp-content/debug.log, o il log PHP del pannello hosting. L’ultima riga prima del crash dice quasi sempre quale file è in difficoltà.
  3. Disattivare il sospetto, non tutto. Dal file manager o via FTP si rinomina la cartella di quel singolo plugin (da nome-plugin a nome-plugin-off). WordPress lo trova disattivato e riparte. Se il sito torna, hai la conferma.
  4. Il tema. Se non era un plugin, si passa temporaneamente a un tema di default. Se con quello il sito funziona, il problema è nel tema o in una sua personalizzazione.
  5. Versione di PHP e memoria. Due classici: l’hosting ha aggiornato PHP e un plugin vecchio non sta al passo, o il memory_limit è troppo basso per quello che il sito carica.
  6. Il backup, per ultimo. Il ripristino rimette in piedi il sito, non rimuove la causa: se non hai capito cosa è successo, al primo aggiornamento sei di nuovo lì, e hai perso gli ordini arrivati dopo il backup.

Cosa non funziona (e si fa comunque, per il panico)

Reinstallare WordPress «per pulire». Il core quasi mai è il problema: sovrascriverlo non tocca plugin, tema e database, cioè dove sta l’errore nove volte su dieci.

Svuotare la cache e ricaricare. Serve dopo aver risolto. Da solo non ha mai sistemato un errore fatale di PHP.

Aggiornare tutto in blocco mentre il sito è giù. È il modo più rapido per aggiungere due incompatibilità nuove a quella che non hai ancora individuato.

Disattivare tutti i plugin e riattivarli insieme. Il sito torna su e tu non sai perché. Riattivandoli in blocco si rompe di nuovo e sei al punto di partenza. Si riattivano uno alla volta, ricaricando ogni volta.

Chiedere all’hosting di «rimettere a posto». L’assistenza fa bene la sua parte — PHP, limiti, permessi, ripristino dai loro snapshot — ma non conosce il tuo sito: spesso rimette lo stato di ieri, cioè il sito con dentro la stessa bomba a orologeria.

Modificare i file dall’editor della bacheca. Un errore di sintassi lì ti chiude anche la bacheca, e resti senza nemmeno quell’editor. Si lavora da FTP, con una copia del file prima di toccarlo.

Da dove arriva, quasi sempre

Nei siti che gestisco le cause si ripetono: l’aggiornamento automatico di un plugin durante la notte; la versione di PHP alzata dall’hosting su un sito con plugin fermi da due anni; uno snippet copiato in functions.php da un forum; il memory_limit stretto su un e-commerce con troppe estensioni; due plugin che fanno la stessa cosa e si pestano i piedi.

Il filo comune è il codice di troppo. Un sito con dodici plugin ben scelti si rompe meno di uno con quaranta, e quando si rompe trovi la causa in un quarto del tempo: ne ho scritto in quanti plugin installare su WordPress.

Quanto costa rimetterlo in piedi

I prezzi sono quelli pubblici del mio catalogo, IVA esclusa.

Se il sito è giù adesso, l’intervento è il Pronto Soccorso Sito, 120 €: trovo la causa, la rimuovo e ti scrivo cosa l’aveva provocata. Perché non succeda più, la manutenzione WordPress costa 90 € al mese e comprende gli aggiornamenti fatti in ordine, con controllo dopo. Il backup automatico si imposta una volta a 120 €; l’intervento di sicurezza costa 290 € e serve quando l’errore critico è il sintomo di un sito compromesso, non di un aggiornamento andato male.

Quando l’errore nasce da codice su misura, invece, si lavora sulla causa. Un plugin WooCommerce su misura costa 800 € e sostituisce i tre plugin generici che litigavano; la personalizzazione del checkout 490 €, al posto degli snippet accumulati nel tema; l’integrazione API 900 € e l’integrazione con il gestionale 1.500 €, scritte per non andare in timeout quando il catalogo cresce. Nella stessa area ci sono l’importazione prodotti da CSV a 400 €, l’area riservata clienti a 990 € e la sincronizzazione con Amazon ed eBay a 990 €: l’archivio è Sviluppo & Custom.

Se il sito è tornato ma le pagine non rientrano nei risultati di ricerca, il controllo è un audit SEO tecnico, 190 €. Se non sai da dove partire, una call strategica costa 97 €.

Come si evita la volta dopo

Tre cose, in ordine di quanto rendono. Un ambiente di staging dove provare gli aggiornamenti prima di farli sul sito vero. Aggiornamenti scaglionati: core, poi i plugin uno per volta, con un giro sul sito dopo ognuno — ne ho scritto in aggiornare WordPress senza perdere dati. E una mail di amministratore che qualcuno legge davvero, perché è lì che WordPress ti scrive chi ha rotto il sito.

Se il sito è lento ma non è giù, il problema è un altro: perché il mio sito è lento.

Domande che mi fanno sempre

Cosa significa «si è verificato un errore critico sul tuo sito web»?

Significa che WordPress ha incontrato un errore fatale di PHP e ha fermato il caricamento della pagina. Non è hosting scaduto né sito cancellato: un pezzo di codice — quasi sempre un plugin o il tema — si è bloccato. Il file e la riga sono nella mail che WordPress manda all’amministratore e nel log degli errori PHP.

Si perdono i dati quando WordPress va in errore critico?

Nella grande maggioranza dei casi no. Articoli, pagine, prodotti, ordini e utenti stanno nel database, che l’errore non tocca: a fermarsi è il codice che li legge. Il rischio arriva dai rimedi fatti di fretta: un backup vecchio che sovrascrive gli ordini del frattempo, o una reinstallazione che cancella le personalizzazioni.

Quali sono le cause più comuni?

L’aggiornamento di un plugin incompatibile, la versione di PHP cambiata dall’hosting, uno snippet aggiunto nel file del tema, il limite di memoria troppo basso e due plugin che svolgono la stessa funzione. Si controllano in quest’ordine: il primo copre da solo la maggior parte dei casi che vedo.

Devo ripristinare il backup o prima cercare la causa?

Prima la causa, se il sito non è un e-commerce fermo in giornata di vendite. Il ripristino nasconde il problema e lo riporta identico al prossimo aggiornamento, e ti costa gli ordini arrivati dopo il punto di ripristino. Se invece ogni ora offline è un danno, si ripristina per tornare online e si cerca la causa subito dopo, su una copia.

Questa guida fa parte della serie in cui spiego, area per area, come lavoro e quanto costa: la guida ai servizi.

0