Messaggio WhatsApp del cliente
« Abbiamo finalizzato la migrazione stanotte, stamattina è tutto bianco. Front e admin. Aiuto. »
🚨 Schermata bianca · Diagnosi immediata
Schermata bianca sul tuo PrestaShop ?
Schermata bianca sul tuo PrestaShop ?
rimettiamo tutto online, senza toccare i tuoi dati.
Diagnosi e risoluzione di schermate bianche PrestaShop
Una schermata completamente bianca — nessun errore, nessun 500, solo il vuoto — è quasi sempre un errore PHP fatale silenzioso. Attiviamo il debug, leggiamo l'errore reale, neutralizziamo il colpevole (modulo, override, hook) e ripristiniamo il tuo negozio senza perdere un solo ordine.
✓ Nessuna perdita di dati
✓ Intervento entro 24 h lavorative
✓ A partire da 60 €/h + IVA su preventivo
✓ Garanzia 30 giorni
👀 Quale tipo di schermata bianca
4 scenari che gestiamo ogni settimana
Il contesto in cui appare la schermata bianca orienta già la diagnosi. Riconosci il tuo.
A. Tutto è bianco (front + admin)
Non risponde più nulla, né la home, né le schede prodotto, né l'URL /admin-xxx. Causa tipica : file core corrotto (spesso config/defines.inc.php o config/config.inc.php modificato male), errore nel composer.json su PS 8.x/9.x, oppure autoloader rotto. Soluzione : ripristino mirato del file in causa + audit git dell'ultimo diff.
B. Front bianco, admin OK
Puoi accedere al back-office, ma il front mostra il bianco — compresa la home page. Causa tipica : hook di modulo agganciato a displayHeader che lancia un'eccezione, oppure tema corrotto (template layouts/layout-full-width.tpl con parse error). Soluzione : passaggio al tema predefinito classic via SQL, identificazione del modulo problematico.
C. Admin bianco, front OK
I tuoi visitatori vedono regolarmente il negozio ma tu non riesci più ad accedere al BO : schermata bianca già da /admin-xxx o dopo il login. Causa tipica : override di controller admin rotto dopo un update, oppure modulo che va in crash su actionAdminControllerInitBefore. Soluzione : neutralizzazione di /override/controllers/admin/, disattivazione SQL dei moduli installati di recente.
D. Bianco solo su alcune schede prodotto
La home, il catalogo e il checkout funzionano, ma alcune schede prodotto sono bianche. Spesso legato a un modulo che va in crash quando è presente un attributo specifico (combinazioni, personalizzazioni, accessori collegati). Soluzione : identificazione del prodotto pivot, disattivazione mirata dell'hook colpevole, patch.
🩺 Tabella diagnostica
Cosa la schermata bianca dice (o non dice)
Pochi minuti in modalità debug bastano spesso a isolare la causa. Ecco la griglia che usiamo.
⚡ Intervento tipo
Cronologia di una schermata bianca risolta in 52 min
Caso reale · Negozio moda bambini · PrestaShop 1.7.8 → migrazione in corso verso 8.1 · Maggio 2026.
Attivazione del debug in pre-prod
Accesso SSH. Modifica di
app/config/parameters.php : '_PS_MODE_DEV_' => true. Refresh.
Errore identificato
Fatal error: Declaration of CustomProductCore::getPrice() must be compatible with ProductCore::getPrice(...). Override di Product in /override/classes/Product.php incompatibile con la firma 8.x.
Override migrato alla nuova firma
Aggiunta del parametro
?int $id_customization = null alla firma, aggiornamento delle chiamate parent::getPrice(). Test su 3 schede prodotto : rendering OK.
Disattivazione debug · deploy in prod
Patch pubblicata.
_PS_MODE_DEV_ rimesso a false. Cache svuotata. Sito OK : front + admin funzionanti.
Audit degli altri override
Scansione completa di
/override/ : altri 4 metodi con firme da aggiornare. Preventivo inviato per una migrazione pulita in 2 h aggiuntive.
52 min
Tempo di rimessa online
~ 55 €
Fatturato su preventivo
(52 min × 60 €/h)
(52 min × 60 €/h)
0
Dati persi
💰 Tariffe
Tariffe annunciate in anticipo
Diagnosi gratuita. Per l'intervento, sai esattamente quanto costa prima che metta mano al codice.
🔍 Diagnosi
Diagnosi
vedere l'errore nascosto
0€gratis
30 min · senza impegno
- Modalità debug PrestaShop attivata temporaneamente
- Modulo / override difettoso identificato
- Preventivo dettagliato inviato immediatamente
- Decidi tu se continuare
⚡ Il più richiesto
🔧 Intervento
Intervento mirato
ripristinare il negozio
da 60€+ IVA
in base alla diagnosi · prezzo annunciato in anticipo
- Backup file + DB prima dell'intervento
- Neutralizzazione del modulo / override difettoso
- Debug disattivato, cache Smarty svuotata, test in prod
- Report scritto causa + correzione applicata
- Garanzia 30 giorni sulla correzione
🛡️ Manutenzione
Manutenzione mensile
test pre-prod prima di ogni update
da 50€/ mese
monitoraggio 24/7 · senza impegno
- Audit dei moduli prima di ogni major update
- Backup automatici giornalieri esternalizzati
- Intervento prioritario in caso di schermata bianca
- Monitoraggio override + migrazione a ogni aggiornamento
🧭 Non confondere
La schermata bianca non è...
❌ Non è un errore 500
Se vedi HTTP ERROR 500 o Internal Server Error, è il server che restituisce uno stato 500, non una schermata bianca. La diagnosi è diversa — vedi la scheda errore 500.
❌ Non è un negozio chiuso
❌ Non è WordPress
Se PrestaShop mostra la tua pagina « Negozio in manutenzione » personalizzata, è semplicemente la modalità manutenzione attivata in Preferenze → Manutenzione. Disattivabile in 5 clic.
Sei su WordPress, non su PrestaShop ? Una schermata bianca WP ha cause molto diverse (plugin, tema, wp-config.php). Abbiamo una scheda dedicata.
❓ FAQ
Schermata bianca PrestaShop — le tue domande frequenti
Una schermata bianca significa che il server ha effettivamente servito del contenuto (HTTP 200) ma che questo contenuto è vuoto. È tipicamente un errore PHP fatale silenzioso :
display_errors è disattivata in produzione, quindi PHP inghiotte l'errore e Smarty genera un template vuoto. Cause frequenti : override di classe che lancia al bootstrap, hook di modulo che va in crash al caricamento del tema, defines_custom.inc.php modificato male, cache Smarty corrotta.Un 500 viene mostrato da Apache/Nginx con un messaggio esplicito. Una schermata bianca è uno stato HTTP 200 OK con un corpo vuoto : PHP è andato in crash ma l'errore è stato nascosto. Gli strumenti di diagnosi differiscono : per una schermata bianca bisogna riattivare manualmente la modalità debug PrestaShop.
Caso classico di override di controller admin rotto o di modulo che va in crash solo lato BO. Si accede via SSH/FTP, si disattiva temporaneamente
/override/controllers/admin/ rinominandolo, si testa, si isola il file colpevole. Se questo non risolve, si disattivano i moduli installati di recente via SQL. Risoluzione 30-60 min.Molto frequente, raramente grave in termini di dati. Un aggiornamento 1.7→8 o 8.x→9 riscrive molte classi core : i tuoi override possono fare riferimento a metodi scomparsi o cambiati. Anche i moduli vecchi che non si sono adeguati. La soluzione consiste nel neutralizzare
/override/, identificare gli override da migrare, fare l'audit dei moduli. I tuoi ordini, clienti e catalogo restano intatti.Diagnosi gratuita (30 min) poi intervento su preventivo, a partire da 60 €/h + IVA. La maggior parte delle schermate bianche viene risolta in 1-2 h una volta identificata la causa. Il preventivo viene inviato entro 24 h lavorative prima di qualsiasi avvio : sai cosa paghi prima che si metta mano al sito. Incluso nella manutenzione Business/Performance.
Su PrestaShop 1.7+, modifica
/config/defines.inc.php : define('_PS_MODE_DEV_', true);. Su 8.x/9.x, usa /app/config/parameters.php. Questa modalità non deve MAI restare attiva in produzione (espone percorsi del server e dati sensibili). La si attiva per 5 minuti, si legge l'errore, la si disattiva, si corregge.Tre passaggi : (1) Rinomina la cartella del modulo in
/modules/ (es.: monmodule_OFF). (2) In SQL : UPDATE ps_module SET active=0 WHERE name='nome_del_modulo';. (3) Svuota la cache Smarty (eliminazione di /var/cache/prod/). Se non ti senti a tuo agio, ce ne occupiamo noi — diagnosi gratuita poi intervento su preventivo a partire da 60 €/h + IVA.
🛡️ Mai più
Per evitare che una schermata bianca ritorni dopo ogni update
Test pre-prod sistematici prima di ogni update, audit degli override, monitoraggio dei moduli incompatibili : è esattamente ciò che fa la nostra manutenzione Performance a 129 €/mese.
Vedi le formule di manutenzione →Il tuo sito è bianco in questo momento ?
Diagnosi gratuita in 30 min poi intervento su preventivo a partire da 60 €/h + IVA. Sai cosa paghi prima che si metta mano al sito.