Il tuo shop è offline e ogni secondo che passa brucia soldi. Schermo bianco, errore 500, checkout che non risponde — quando PrestaShop non funziona, il panico è la prima reazione. Ma il panico non ripristina i server.
Quello che serve è un metodo. Prima di toccare qualsiasi file o reinstallare moduli a caso, devi sapere dove guardare e in quale ordine. Questa guida ti porta dalla diagnosi iniziale alla risoluzione dei problemi più comuni, con procedure concrete da eseguire subito — anche senza un tecnico al telefono.
⚠️ Hai il sito in errore 500 proprio adesso?
Ho trasformato il mio metodo di diagnosi in un modulo: Errore 500 Detective AI individua la causa esatta (modulo in conflitto, override, .htaccess, limiti di memoria) e ti dice come risolverla — in automatico, senza aspettare un tecnico. Lo installi in 60 secondi ed è tuo per sempre.
Risolvi ora — €67 →Rimborso garantito 30 giorniQuando riscontri anomalie e il tuo PrestaShop non funziona, il primo istinto è spesso quello di modificare file a caso o installare nuovi moduli sperando in un miracolo. Questo approccio peggiora quasi sempre la situazione. La risoluzione dei problemi richiede metodo e analisi sistematica.
Per prima cosa, devi capire se il disservizio dipende dall'applicazione PrestaShop o da un problema infrastrutturale del server. Segui questi passi nell'ordine:
/admin) è accessibile, il problema riguarda quasi certamente un modulo, un tema o una configurazione recente — non il server.Regola d'oro: isolare il perimetro del problema riduce drasticamente i tempi di risoluzione. Non toccare nulla finché non sai dove guardare.
Se invece visualizzi un errore del tipo "502 Bad Gateway" o "504 Gateway Timeout", la causa risiede probabilmente nelle risorse del tuo hosting o in un blocco del server web — non in PrestaShop stesso.
Lo schermo bianco su PrestaShop (detto anche White Screen of Death) e l'errore 500 sono le manifestazioni più comuni di un crash PHP. Per sicurezza, PHP nasconde i dettagli dell'errore all'utente finale — ma puoi sbloccare queste informazioni attivando la modalità debug.
Se non hai accesso al pannello di amministrazione, devi intervenire direttamente sui file via FTP (ad es. FileZilla) o tramite il File Manager del tuo hosting.
/config/ (valido per PrestaShop 1.7 e PrestaShop 8).defines.inc.php come backup, poi aprilo con un editor (Notepad++, VS Code).define('_PS_MODE_DEV_', false);
12 controlli da fare in 5 minuti per capire se serve un intervento urgente — prima di chiamare il tecnico.
Quando il sito non va, sembra sempre la fine. Ma il 60% dei casi si risolve con 3 click. Questa checklist ti dice esattamente quali controlli fare, in che ordine, e a quale punto chiamare un esperto.
Gratuito. Arriva in 30 secondi.
define('_PS_MODE_DEV_', true);
⚠️ Importante: una volta risolto il problema, riporta
_PS_MODE_DEV_afalse. Lasciarlo attivo in produzione espone informazioni sensibili del tuo server.
PrestaShop è un CMS esigente in termini di risorse. Se il server esaurisce la RAM allocata per gli script PHP, il sito si blocca mostrando uno schermo bianco o un errore 500. In modalità debug vedrai:
Fatal error: Allowed memory size of X bytes exhausted
Per aumentare il memory_limit, usa uno di questi tre metodi a seconda della configurazione del tuo hosting:
.htaccess (aggiungi in cima al file nella root):php_value memory_limit 512M
php.ini o .user.ini:memory_limit = 512M
memory_limit a 512M o superiore.Se il report di errore in modalità debug punta a un file nella cartella /modules/, un modulo specifico sta mandando in crash il sistema. Questo accade spesso dopo un aggiornamento o quando si passa a una versione PHP incompatibile.
Soluzione rapida via FTP:
1. Entra nella cartella /modules/.
2. Individua la directory del modulo incriminato (es. /modules/nomemodulo/).
3. Rinomina la cartella aggiungendo un suffisso: /modules/nomemodulo_old/.
Questo costringe PrestaShop a ignorare il modulo al caricamento, permettendoti di rientrare nel sito e cercare un aggiornamento compatibile. Non cancellarlo subito: potrebbe contenere configurazioni utili.
Un'altra causa frequente per cui PrestaShop non funziona riguarda il database MySQL. Gli errori di database sono tipicamente i più critici perché coinvolgono i dati di prodotto, ordini e clienti.
| Messaggio di errore | Causa probabile | Soluzione |
|---|---|---|
Error 1005: Can't create table |
Tabella corrotta o vincolo FK violato | Ripara le tabelle via phpMyAdmin |
MySQL server has gone away |
Timeout connessione o query troppo pesante | Aumenta wait_timeout e max_allowed_packet |
Too many connections |
Esaurite le connessioni MySQL disponibili | Contatta l'hosting o ottimizza le query |
Table 'ps_xxx' doesn't exist |
Prefisso database errato in configurazione | Verifica _DB_PREFIX_ in /config/settings.inc.php |
Backup prima di tutto: prima di qualsiasi intervento sul database, esegui sempre un'esportazione completa tramite phpMyAdmin → Export → Quick → SQL. Un backup che non esiste non serve a niente nel momento del bisogno.
Il carrello e la pagina di checkout rappresentano il cuore pulsante del tuo business. Se questa sezione presenta dei blocchi, stai perdendo fatturato in tempo reale. I problemi al checkout si manifestano con un carrello che non si aggiorna, il pulsante "Procedi al pagamento" inattivo, o i metodi di pagamento che scompaiono improvvisamente.
Modulo di pagamento non configurato o scaduto
Verifica che le API key di PayPal, Stripe, Klarna o qualsiasi altro gateway siano corrette e aggiornate. Controlla anche eventuali avvisi di sicurezza nei rispettivi account merchant — un account sospeso blocca silenziosamente le transazioni senza mostrare errori visibili all'utente.
Certificato SSL scaduto o errore mixed content
Se la pagina di checkout carica risorse via HTTP all'interno di una pagina HTTPS, browser e gateway di pagamento bloccheranno la transazione. Verifica la scadenza del certificato SSL e usa la console del browser (F12 → Console) per individuare errori Mixed Content.
JavaScript rotto nella pagina checkout
Apri la pagina di checkout, premi F12, vai sulla scheda Console. Righe rosse indicano errori JavaScript: spesso un modulo di chat, un pixel di tracciamento o un tema non ottimizzato genera un conflitto che impedisce l'esecuzione del codice di checkout. Identificato il modulo responsabile, disabilitalo e testa nuovamente.
Carrier non configurato per il paese del cliente
Se i clienti non vedono metodi di spedizione disponibili durante il checkout, verifica in Back Office → Spedizione → Corrieri che ogni corriere sia associato correttamente alle zone geografiche e alle fasce di peso previste.
Cache non aggiornata
Dopo qualsiasi modifica, svuota la cache da Back Office → Parametri avanzati → Performance → "Svuota la cache". Se il problema persiste, elimina manualmente il contenuto della cartella /var/cache/ via FTP.
Un PrestaShop lento non è "solo un fastidio": Google penalizza i siti con tempi di caricamento elevati e gli utenti abbandonano dopo pochi secondi di attesa. Se il sito non è completamente offline ma risponde con estrema lentezza, considera questi scenari.
Gli aggiornamenti sono tra le operazioni più rischiose su PrestaShop. Un aggiornamento mal gestito può rendere il sito completamente inaccessibile nel giro di pochi minuti.
Passo 1 — Ripristina il backup
Se hai usato il modulo "1-Click Upgrade" (autoupgrade), nella cartella /admin/autoupgrade/ trovi un archivio del sito pre-aggiornamento. Ripristinalo tramite FTP e phpMyAdmin il prima possibile.
Passo 2 — Verifica compatibilità moduli e tema
Ogni modulo e ogni tema devono essere compatibili con la nuova versione di PrestaShop. Dopo un aggiornamento, disabilita tutti i moduli di terze parti (via FTP, rinominando le cartelle) e verifica se il sito torna operativo con il tema di default (Classic o Hummingbird per PS8).
Passo 3 — Controlla gli override
PrestaShop permette di sovrascrivere le classi core tramite la cartella /override/. Dopo un aggiornamento, questi file possono entrare in conflitto con il nuovo codice. Svuota la cartella /override/ (dopo aver fatto backup) e cancella il file /cache/class_index.php per forzare la rigenerazione dell'indice.
Passo 4 — Rigenera il file .htaccess
L'aggiornamento può corrompere il file .htaccess con conseguenti errori 404 o 500. Rigenera le regole di riscrittura da Back Office → Parametri SEO e URL → "Genera file .htaccess".
Se riesci ad aprire il front office ma non riesci ad accedere alla pagina di amministrazione, le cause più probabili sono tre.
Accedi a phpMyAdmin, seleziona il database di PrestaShop e apri la tabella ps_employee (o con il prefisso personalizzato). Individua il tuo account e aggiorna il campo passwd inserendo l'hash MD5 della nuova password. In alternativa, usa la funzionalità "Password dimenticata" se le email transazionali del sito funzionano correttamente.
Per sicurezza, PrestaShop rinomina la cartella /admin/ durante l'installazione con un suffisso casuale (es. /admin7xy3k/). Se non ricordi il nome, connettiti via FTP e cercala direttamente nella root del sito — sarà visibile nell'elenco delle cartelle.
Alcuni hosting implementano un WAF (Web Application Firewall) che blocca automaticamente l'IP dopo N tentativi di login falliti. Controlla le impostazioni del firewall nel pannello del tuo hosting o contatta l'assistenza tecnica per sbloccare il tuo indirizzo IP.
Quando PrestaShop non funziona, usa questa lista come punto di riferimento prima di qualsiasi intervento:
_PS_MODE_DEV_ = true) per leggere l'errore esatto/var/cache/ + CCC dal back office).htaccess da Back Office → SEO e URLLo schermo bianco (White Screen of Death) è causato da un errore PHP che il sistema nasconde per motivi di sicurezza. Per visualizzare il messaggio di errore reale, devi attivare la modalità di debug modificando il file /config/defines.inc.php e impostando _PS_MODE_DEV_ su true. Una volta identificata la causa — solitamente un modulo incompatibile o un limite di memoria superato — potrai risolverla e riportare il parametro a false.
Se il problema è comparso subito dopo l'installazione di un nuovo modulo, accedi via FTP alla cartella /modules/, individua la directory del modulo appena installato e rinominala aggiungendo _old o _disabled al nome. Questo disabilita il modulo senza cancellarlo. Se il sito torna operativo, contatta lo sviluppatore per una versione compatibile con la tua versione di PrestaShop.
In questo caso devi operare interamente via FTP e phpMyAdmin. Tramite FTP puoi attivare la modalità debug, disabilitare moduli e pulire la cache. Tramite phpMyAdmin puoi ripristinare un backup del database o riparare le tabelle corrotte. Se hai un backup recente (file + database), il ripristino completo è l'opzione più sicura e veloce per tornare online.
Dipende. Se il sito è sempre stato lento, probabilmente l'hosting è sottodimensionato o mancano le ottimizzazioni di base (cache, CCC, CDN, PHP aggiornato). Se la lentezza è comparsa improvvisamente, è più probabile che sia causata da un modulo problematico, un picco di traffico o una query SQL mal ottimizzata che si è aggravata con la crescita del catalogo. I log del server e gli strumenti di profilazione sono i tuoi migliori alleati per identificare il collo di bottiglia.
Questo errore indica che il server MySQL ha raggiunto il numero massimo di connessioni contemporanee consentite. Le soluzioni principali sono: aumentare il valore max_connections nella configurazione MySQL, attivare un sistema di cache persistente (Memcached/Redis) per ridurre il numero di query, ottimizzare i moduli che generano troppe connessioni e, se necessario, passare a un piano hosting con risorse dedicate maggiori.
Dipende interamente dalla causa. Problemi semplici come un modulo incompatibile o la cache da svuotare si risolvono in 5-15 minuti seguendo la procedura corretta. Problemi più complessi come un aggiornamento fallito, un database corrotto o un attacco hacker possono richiedere da alcune ore a un'intera giornata lavorativa. Avere un backup recente dimezza i tempi in quasi tutti gli scenari — è l'unica vera polizza assicurativa per il tuo e-commerce.
Hai seguito tutti i passaggi e il tuo PrestaShop non funziona ancora? A volte il problema è più profondo — un database compromesso, un attacco in corso, un aggiornamento che ha corrotto file critici. Sono situazioni che richiedono esperienza diretta sulla piattaforma, non un altro tutorial.
Su francescoingrosso.com trovi il Kit Recupero PrestaShop (€697, intervento one shot), pensato esattamente per queste emergenze: siti down, e-commerce hackerati, installazioni che non ripartono nonostante tutti i tentativi. Se invece il tuo negozio funziona ma vuoi che qualcuno lo tenga in salute ogni mese, il piano Dominio Digitale (€700/mese) include assistenza tecnica continuativa e SEO.
Ogni ora offline è fatturato perso. Agisci adesso.
→ Scopri i servizi su francescoingrosso.com
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Perché PrestaShop mostra uno schermo bianco senza messaggi di errore?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Lo schermo bianco (White Screen of Death) è causato da un errore PHP che il sistema nasconde per motivi di sicurezza. Per visualizzare il messaggio di errore reale, devi attivare la modalità di debug modificando il file /config/defines.inc.php e impostando _PS_MODE_DEV_ su true. Una volta identificata la causa (solitamente un modulo incompatibile o un limite di memoria superato), potrai risolverla e riportare il parametro a false."
}
},
{
"@type": "Question",
"name": "Cosa fare se PrestaShop non funziona dopo aver installato un modulo?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Se il problema è comparso subito dopo l'installazione di un nuovo modulo, accedi via FTP alla cartella /modules/, individua la directory del modulo appena installato e rinominala aggiungendo _old o _disabled al nome. Questo disabilita il modulo senza cancellarlo. Se il sito torna operativo, contatta lo sviluppatore per una versione compatibile con la tua versione di PrestaShop."
}
},
{
"@type": "Question",
"name": "Come ripristino PrestaShop se non ho accesso né al front office né al back office?",
"acceptedAnswer": {
"@type": "Answer",
"text": "In questo caso devi operare interamente via FTP e phpMyAdmin. Tramite FTP puoi attivare la modalità debug, disabilitare moduli e pulire la cache. Tramite phpMyAdmin puoi ripristinare un backup del database o riparare le tabelle corrotte. Se hai un backup recente di file e database, il ripristino completo è l'opzione più sicura e veloce per tornare online."
}
},
{
"@type": "Question",
"name": "PrestaShop è lento: è colpa del sito o dell'hosting?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Dipende. Se il sito è sempre stato lento, probabilmente l'hosting è sottodimensionato o mancano le ottimizzazioni di base (cache, CCC, CDN, PHP aggiornato). Se la lentezza è comparsa improvvisamente, è più probabile che sia causata da un modulo problematico, un picco di traffico o una query SQL mal ottimizzata. I log del server e gli strumenti di profilazione sono i migliori alleati per identificare il collo di bottiglia."
}
},
{
"@type": "Question",
"name": "Come si risolve l'errore 'Too many connections' su PrestaShop?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Questo errore indica che il server MySQL ha raggiunto il numero massimo di connessioni contemporanee consentite. Le soluzioni principali sono: aumentare il valore max_connections nella configurazione MySQL, attivare un sistema di cache persistente come Memcached o Redis per ridurre il numero di query, ottimizzare i moduli che generano troppe connessioni e, se necessario, passare a un piano hosting con risorse dedicate maggiori."
}
},
{
"@type": "Question",
"name": "Quanto tempo ci vuole per risolvere un PrestaShop che non funziona?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Dipende dalla causa. Problemi semplici come un modulo incompatibile o la cache da svuotare si risolvono in 5-15 minuti seguendo la procedura corretta. Problemi più complessi come un aggiornamento fallito, un database corrotto o un attacco hacker possono richiedere da alcune ore a un'intera giornata lavorativa. Avere un backup recente dimezza i tempi in quasi tutti gli scenari."
}
}
]
}
Richiedi un'analisi gratuita del tuo sito. Identifico i problemi tecnici e ti propongo un piano d'azione concreto.
Richiedi Analisi Gratuita
Da quando c'è la Direttiva Omnibus, ogni sconto deve mostrare il prezzo più basso applicato nei 30 giorni precedenti. Se non lo fai, per la legge è uno sconto civetta. Ti spiego cosa rischi e come metterti a norma in automatico.
Leggi tutto →
Dal 28 giugno 2025 l'European Accessibility Act obbliga gli e-commerce a essere accessibili. Un PrestaShop non a norma rischia sanzioni e perde i clienti con disabilita. Il Kit Accessibilita aggiunge widget e dichiarazione conformi per 67 euro una tantum.
Leggi tutto →
L'AI Act europeo impone trasparenza sui contenuti generati con l'intelligenza artificiale. Se usi testi o immagini AI sulle schede del tuo e-commerce PrestaShop, vanno dichiarati. In questo articolo capisci cosa dice la norma, perche riguarda anche te, e come mettere la dichiarazione conforme in automatico col modulo AI Disclosure a 67 euro una tantum.
Leggi tutto →
Scritto da
15 anni su PrestaShop, 300+ store seguiti. Ingegnere del software: lavoro ogni giorno su e-commerce reali, tra migrazioni, performance e recupero vendite.