PrestaShop Non Funziona: Guida Completa ai Problemi

PrestaShop Non Funziona: Guida Completa ai Problemi

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.

Indice dei Contenuti

1. Da dove iniziare la diagnosi
2. Schermo bianco e errore 500
3. Problemi di database
4. Checkout bloccato
5. PrestaShop lento o irraggiungibile
6. Errori dopo aggiornamento
7. Back office non accessibile
8. Checklist rapida di ripristino
9. FAQ

Il tuo PrestaShop non funziona: da dove iniziare la diagnosi

Quando 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.

Identifica l'ambito del problema

Per prima cosa, devi capire se il disservizio dipende dall'applicazione PrestaShop o da un problema infrastrutturale del server. Segui questi passi nell'ordine:

1. Testa da connessioni diverse: prova ad accedere al sito da dispositivi diversi o usando una connessione mobile per escludere blocchi legati al tuo IP o alla cache locale.
2. Verifica se è giù solo per te: usa strumenti come downforeveryoneorjustme.com per capire se il sito è irraggiungibile globalmente.
3. Controlla i log del server: accedi al pannello del tuo hosting (cPanel, Plesk) e consulta i log di errore Apache/Nginx. Spesso contengono la causa precisa in poche righe.
4. Isola front office vs back office: se il front office è in errore ma il back office (/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.

Schermo bianco e PrestaShop errore 500

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.

Come attivare la modalità di debug su PrestaShop

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.

1. Connettiti al server e naviga fino alla cartella principale della tua installazione.
2. Apri la cartella /config/ (valido per PrestaShop 1.7 e PrestaShop 8).
3. Scarica il file defines.inc.php come backup, poi aprilo con un editor (Notepad++, VS Code).
4. Individua la riga (solitamente intorno alla riga 29):

define('_PS_MODE_DEV_', false);

5. Modifica il valore in:

define('_PS_MODE_DEV_', true);

6. Carica il file modificato sul server, sovrascrivendo quello esistente.
7. Ricarica la pagina che mostrava lo schermo bianco: ora vedrai il dettaglio dell'errore con il file e la riga di codice che ha causato il blocco.

⚠️ Importante: una volta risolto il problema, riporta _PS_MODE_DEV_ a false. Lasciarlo attivo in produzione espone informazioni sensibili del tuo server.

Risolvere il limite di memoria PHP (memory_limit)

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:

• File .htaccess (aggiungi in cima al file nella root):

php_value memory_limit 512M

• File php.ini o .user.ini:

memory_limit = 512M

• Pannello di controllo (cPanel → "Seleziona versione PHP" → "Opzioni"): imposta memory_limit a 512M o superiore.

Individuare e disabilitare un modulo corrotto

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.

Problemi di database su PrestaShop

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.

Errori comuni di database

Come riparare le tabelle del database

1. Accedi a phpMyAdmin dal pannello del tuo hosting.
2. Seleziona il database del tuo PrestaShop.
3. Clicca su "Seleziona tutto" per selezionare tutte le tabelle.
4. Dal menu a tendina in basso, scegli "Ripara tabelle".
5. Attendi il completamento dell'operazione e ricarica il sito.

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.

Checkout bloccato su PrestaShop

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.

Cause frequenti e soluzioni

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.

PrestaShop lento o irraggiungibile

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.

Principali cause di lentezza

• Hosting sottodimensionato: un piano shared hosting con risorse condivise non è adatto a un e-commerce con molti prodotti o traffico sostenuto. Valuta il passaggio a un VPS o a un hosting gestito per PrestaShop.
• Mancanza di cache: se la cache di Smarty e del file system non è abilitata, PrestaShop rigenera ogni pagina da zero a ogni visita. Attivala da Back Office → Performance.
• Immagini non ottimizzate: immagini di prodotto da 5-10 MB rallentano drasticamente il sito. Usa strumenti come TinyPNG o un modulo di ottimizzazione immagini prima del caricamento.
• Troppe richieste al database: moduli mal sviluppati possono generare decine di query SQL per ogni singola pagina. Usa gli strumenti di debug nativo per identificarli.
• PHP obsoleto: PrestaShop 8 richiede PHP 8.1+. Girare su versioni inferiori non solo è insicuro, ma genera rallentamenti significativi e incompatibilità.

Azioni immediate per velocizzare PrestaShop

1. Attiva CCC (Combine, Compress, Cache) da Back Office → Performance → CCC.
2. Abilita la cache di Memcached o Redis se il tuo hosting lo supporta.
3. Aggiorna PHP alla versione raccomandata per la tua versione di PrestaShop.
4. Installa un CDN (es. Cloudflare gratuito) per distribuire i file statici globalmente e ridurre il Time to First Byte.

PrestaShop non funziona dopo un aggiornamento

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.

Cosa fare immediatamente dopo un aggiornamento fallito

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".

Back office non accessibile

Se riesci ad aprire il front office ma non riesci ad accedere alla pagina di amministrazione, le cause più probabili sono tre.

Hai dimenticato o perso le credenziali di accesso

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.

L'URL della cartella admin è cambiato

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.

Sei stato bloccato per troppi tentativi di login falliti

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.

Checklist rapida di ripristino

Quando PrestaShop non funziona, usa questa lista come punto di riferimento prima di qualsiasi intervento:

• [ ] Backup completo di file e database prima di toccare qualsiasi cosa
• [ ] Verifica se il problema riguarda front office, back office o entrambi
• [ ] Attiva la modalità debug (_PS_MODE_DEV_ = true) per leggere l'errore esatto
• [ ] Controlla i log del server Apache/Nginx nel pannello hosting
• [ ] Verifica il memory_limit PHP (deve essere almeno 256M, consigliato 512M)
• [ ] Disabilita tutti i moduli di terze parti via FTP e testa nuovamente
• [ ] Passa al tema di default (Classic/Hummingbird) per escludere problemi di tema
• [ ] Svuota la cache (/var/cache/ + CCC dal back office)
• [ ] Ripara le tabelle del database via phpMyAdmin
• [ ] Rigenera il file .htaccess da Back Office → SEO e URL
• [ ] Verifica che la versione PHP sia compatibile con la tua versione di PrestaShop
• [ ] Ripristina il backup se nessun altro intervento funziona

FAQ — Domande frequenti su PrestaShop che non funziona

Perché PrestaShop mostra uno schermo bianco senza messaggi di errore?

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.

Cosa fare se PrestaShop non funziona dopo aver installato un modulo?

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.

Come ripristino PrestaShop se non ho accesso né al front office né al back office?

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.

PrestaShop è lento: è colpa del sito o dell'hosting?

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.

Come si risolve l'errore "Too many connections" su PrestaShop?

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.

Quanto tempo ci vuole per risolvere un PrestaShop che non funziona?

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.

Il problema non si risolve? Entra in azione ora

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."
      }
    }
  ]
}

Leggi anche

Problemi PrestaShop

Schema markup per PrestaShop: come ottenere rich snippets in 7 giorni

Guida completa su schema markup prestashop per proprietari di e-commerce PrestaShop.

Leggi tutto →

Problemi PrestaShop

Perché ChatGPT ti scrive schede prodotto da brochure (e come farlo smettere in un pomeriggio)

ChatGPT scrive descrizioni vuote perché non sa niente del tuo negozio. Il Dossier è il documento che gli insegna clienti, domande e voce: un pomeriggio di lavoro, e le schede cambiano faccia.

Leggi tutto →

Problemi PrestaShop

Come scalare il traffico organico di un PrestaShop nel 2026: la guida operativa

Guida completa su seo prestashop avanzata per proprietari di e-commerce PrestaShop.

Leggi tutto →

Scritto da

Francesco Ingrosso

15 anni su PrestaShop, 300+ store seguiti. Ingegnere del software: lavoro ogni giorno su e-commerce reali, tra migrazioni, performance e recupero vendite.

Scopri chi sono → LinkedIn