Errore 500 su PrestaShop: la mappa delle 12 cause più frequenti (e come risolverle)

Il negozio è online, poi di colpo sparisce.

Pagina bianca. Back office che non entra. Cliente che arriva al checkout e trova un muro. L’errore 500 PrestaShop non è solo un problema tecnico: è la serranda abbassata mentre dovresti vendere.

Il discorso qual è?

Non ti dico che con questa guida risolvi sempre in dieci minuti. Sarebbe una promessa stupida. Ti dico una cosa più utile: se segui l’ordine corretto, eviti di perdere ore a toccare file, moduli e database senza criterio.

Nei negozi PrestaShop il problema è quasi sempre questo: si parte dalla soluzione più comoda, non dalla causa più probabile. Si disattivano moduli a caso, si cambia PHP, si svuota cache, si chiama l’hosting con una frase generica.

Meglio fatto che perfetto, sì. Ma fatto con metodo.

Che cos’è un errore 500 PrestaShop?

Un errore 500 PrestaShop è un errore generico del server.

Significa che PrestaShop non riesce a completare la richiesta e quindi non genera la pagina.

Il server non ti sta dicendo “il problema è questo”. Ti sta dicendo: “mi sono bloccato, guarda nei log”.

Lo puoi trovare anche come errore HTTP 500 PrestaShop, PrestaShop 500 Internal Server Error o, nella pratica, come pagina bianca.

I sintomi più frequenti sono questi:

• front office non visibile;
• back office non accessibile;
• errore solo nel checkout;
• errore solo su prodotti o categorie;
• errore dopo installazione modulo;
• errore dopo aggiornamento PrestaShop;
• errore intermittente, che appare e scompare.

Numero verificabile: secondo la PrestaShop Developer Documentation, Compatibility chart, 2026, PrestaShop 8.1 supporta PHP da 7.2.5 a 8.1, mentre PrestaShop 9 richiede PHP 8.1 o superiore.

Perché ti dico questo?

Perché molti casi di errore 500 PrestaShop nascono proprio dalla compatibilità. Il sito sembra uguale, ma sotto cambia PHP, cambia un modulo, cambia l’hosting. E il negozio si ferma.

Qual è la prima cosa da fare quando compare un errore 500 PrestaShop?

La prima cosa da fare è attivare il debug e leggere l’errore reale.

Senza debug stai lavorando al buio, come cercare un prodotto in magazzino con la luce spenta.

Prima di modificare file o cancellare moduli, segui questa sequenza:

1. segna l’ora esatta in cui è apparso l’errore;
2. ricorda l’ultima modifica fatta;
3. attiva il debug PrestaShop;
4. controlla i log dell’hosting;
5. controlla i log in var/logs o app/logs;
6. intervieni su una causa alla volta.

Per attivare il debug PrestaShop errore 500, nella maggior parte dei casi puoi modificare questo file:

/config/defines.inc.php

Cerca questa riga:

define('_PS_MODE_DEV_', false);

e cambiala in:

define('_PS_MODE_DEV_', true);

Su versioni recenti puoi trovare log più leggibili nella cartella var/logs. Su installazioni più vecchie potresti trovare informazioni in app/logs.

Attenzione: non lasciare il debug attivo online per giorni. Mostra percorsi file, errori PHP e dettagli interni. Serve per diagnosticare, non per informare clienti e bot.

Quali sono le 12 cause più frequenti di errore 500 PrestaShop?

Le cause più frequenti sono moduli, PHP, tema, permessi, cache, database, memoria, .htaccess, override, aggiornamenti incompleti, hosting e file corrotti.

Non devi controllarle in ordine casuale. Parti sempre dall’ultima modifica fatta.

1. Modulo PrestaShop installato o aggiornato male

Il caso classico è semplice: installi un modulo, aggiorni un modulo, svuoti cache e il sito va giù.

L’errore 500 modulo PrestaShop è comune perché un modulo può entrare in punti delicati: checkout, pagamento, spedizione, carrello, hook, template e override.

Soluzione rapida:

• entra via FTP o file manager;
• vai nella cartella /modules;
• rinomina la cartella del modulo sospetto;
• usa un nome tipo nomemodulo_OFF;
• svuota la cache;
• ricarica il sito.

Non ti dico di cancellare subito il modulo. Ti dico di disattivarlo senza distruggere prove utili. È diverso.

Se vuoi approfondire la gestione dei componenti critici, leggi anche come scegliere i moduli PrestaShop.

2. Versione PHP incompatibile

Questo succede spesso dopo un intervento lato hosting. Tu non hai toccato nulla, ma il sito si rompe.

È come se nel negozio fisico cambiassero tutte le prese elettriche durante la notte. Il registratore di cassa è sempre quello, ma non si accende più.

Controlla subito:

• versione PHP attiva sul dominio;
• compatibilità con la versione PrestaShop;
• compatibilità dei moduli installati;
• estensioni PHP abilitate;
• eventuali modifiche fatte dall’hosting.

Se l’errore 500 PrestaShop appare dopo cambio PHP, torna alla versione precedente compatibile. Poi pianifica l’aggiornamento con calma.

3. Tema non compatibile o template rotto

Un tema può rompere solo alcune pagine. Home attiva, scheda prodotto morta. Oppure checkout bloccato.

Il problema non è sempre PrestaShop. A volte il tema richiama variabili, hook o funzioni non più disponibili.

Azioni utili:

• attiva debug e leggi il file template citato;
• verifica se l’errore appare solo con quel tema;
• controlla personalizzazioni recenti;
• testa un tema standard in staging, se possibile.

Senza offesa: modificare il tema live perché “sono due righe” può costarti ore. Fai una copia e lavora lì.

4. Permessi file e cartelle sbagliati

PrestaShop deve leggere e scrivere in alcune cartelle. Se i permessi sono sbagliati, può bloccarsi.

Il problema compare spesso dopo migrazioni, backup ripristinati o interventi FTP fatti in fretta.

Controlla soprattutto:

• /var/cache;
• /cache nelle vecchie versioni;
• /img;
• /modules;
• /themes;
• /upload;
• /download.

Non impostare tutto a 777 perché “così funziona”. È come lasciare aperto il retrobottega. Magari entri tu, ma entra anche chi non deve.

5. Cache corrotta

La cache accelera il sito, ma quando si corrompe può bloccarlo.

Questo è uno dei controlli più rapidi. Non perché sia sempre la causa, ma perché si testa velocemente.

Puoi svuotare:

• cache dal back office, se accessibile;
• /var/cache/prod;
• /var/cache/dev, se presente;
• cache server o cache hosting;
• cache di sistemi come LiteSpeed o Varnish, se configurati.

Se hai una PrestaShop pagina bianca errore 500, la cache va controllata presto. È una prova semplice, reversibile e spesso chiarisce la situazione.

6. File .htaccess danneggiato

Il file .htaccess gestisce URL, redirect, riscritture e regole server.

Se contiene una regola errata o incompatibile, può generare un errore HTTP 500 PrestaShop.

Procedi così:

• fai una copia del file .htaccess attuale;
• rinominalo temporaneamente;
• rigenera il file da PrestaShop, se puoi entrare;
• ripristina una versione pulita compatibile;
• controlla eventuali redirect SEO importanti.

Qui serve attenzione. Se cancelli tutto senza copia, puoi togliere il 500 e creare un problema di traffico organico.

7. Memoria PHP insufficiente

Alcuni errori 500 nascono perché lo script supera il limite di memoria disponibile.

Succede con import prodotti, generazione immagini, cataloghi pesanti, cron aggressivi o moduli troppo carichi.

Nel log potresti vedere un messaggio simile:

Allowed memory size exhausted

Azioni possibili:

• aumentare memory_limit in modo controllato;
• ridurre la dimensione dei batch di importazione;
• disattivare moduli non necessari;
• controllare cron troppo pesanti;
• ottimizzare immagini e processi automatici.

Non ti dico che aumentando memoria risolvi sempre. Ti dico che, se il log parla di memoria, partire dal tema è tempo buttato.

8. Database con tabelle danneggiate o query lente

Il database è il magazzino del tuo e-commerce. Prodotti, clienti, ordini e carrelli passano da lì.

Se il database ha tabelle danneggiate, spazio pieno o query lente, PrestaShop può bloccarsi.

Controlla:

• log MySQL o MariaDB;
• tabelle in crash;
• spazio disco disponibile;
• tabelle log o statistiche troppo grandi;
• moduli che scrivono dati senza pulizia;
• query lente durante checkout o back office.

Noi facciamo l’esempio pessimista. Se il checkout interroga una tabella pesante e il cliente aspetta troppo, non ti manda una mail. Compra altrove.

9. Override rotti

Gli override modificano il comportamento nativo di PrestaShop.

Sono potenti, ma diventano pericolosi quando aggiorni PrestaShop, PHP o moduli collegati.

Li trovi spesso qui:

/override

Azioni consigliate:

• controlla se il debug cita file in /override;
• disattiva temporaneamente override sospetti;
• rigenera la cache classi;
• verifica se un modulo ha creato override;
• documenta ogni modifica fatta.

Che cosa significa?

Un override scritto anni fa può essere incompatibile oggi. Non perché qualcuno fosse incapace. Perché il contesto tecnico è cambiato.

10. Aggiornamento PrestaShop incompleto

L’errore 500 dopo aggiornamento PrestaShop è uno dei casi più delicati.

Può dipendere da file non copiati, database non migrato, moduli incompatibili o cache rimasta sporca.

Controlla subito:

• log dell’aggiornamento;
• versione PHP attiva;
• compatibilità del tema;
• compatibilità dei moduli critici;
• migrazioni database fallite;
• backup pre-aggiornamento;
• cartelle cache e log.

Un e-commerce non si aggiorna come un’app del telefono. Ha pagamenti, corrieri, fatture, ordini, moduli e personalizzazioni.

Se vuoi evitare questi problemi, approfondisci come pianificare un aggiornamento PrestaShop prima di farlo sul sito live.

11. Problemi hosting o risorse server

A volte PrestaShop non è il colpevole principale. Il server ha limiti troppo stretti o problemi temporanei.

Succede con CPU satura, timeout, spazio disco pieno, inode esauriti, WAF o ModSecurity.

All’hosting chiedi dati precisi:

• error log Apache o Nginx;
• log PHP-FPM;
• uso CPU nelle ultime ore;
• memoria consumata;
• spazio disco disponibile;
• eventuali blocchi firewall o WAF.

Non scrivere solo “il sito dà errore 500”. Scrivi: “alle 10:42 compare errore 500 sul checkout, dopo aggiornamento modulo pagamento, log allegato”. Cambia la risposta che ricevi.

12. File core mancanti o corrotti

Se mancano file core, PrestaShop può bloccarsi completamente.

Può succedere dopo upload FTP interrotti, migrazioni, malware, pulizie aggressive o aggiornamenti falliti.

Azioni utili:

• confronta i file con una copia pulita della stessa versione;
• controlla date di modifica sospette;
• verifica file rimossi da antivirus o firewall;
• ripristina da backup sano;
• fai una scansione malware se trovi file strani.

Qui non improvvisare. Ripristinare file core della versione sbagliata può trasformare un problema breve in una giornata persa.

Come risolvere errore 500 PrestaShop se il back office non è accessibile?

Se il back office non è accessibile, devi lavorare da FTP, file manager, database e log server.

Non aspettare di entrare nel pannello. Il pannello è solo una porta, non l’unico accesso al negozio.

L’errore 500 back office PrestaShop spesso dipende da modulo, cache, PHP, permessi o aggiornamento incompleto.

Sequenza operativa:

1. attiva debug da file;
2. leggi errore mostrato o log generato;
3. rinomina il modulo installato per ultimo;
4. svuota cache da FTP;
5. controlla versione PHP;
6. verifica permessi su cache e log;
7. controlla spazio disco;
8. valuta database, override e core.

Se hai installato un modulo alle 9:30 e alle 9:33 il back office è morto, non partire dal database. Parti da quel modulo.

Sembra banale, ma è qui che si perdono ore. L’errore non sta sempre dove guardi meglio. Sta dove è cambiato qualcosa.

Come capire se l’errore 500 PrestaShop dipende da un modulo?

Dipende probabilmente da un modulo se l’errore appare dopo installazione, aggiornamento o configurazione del modulo stesso.

Il test più veloce è rinominare la cartella del modulo via FTP.

Il discorso qual è?

Un modulo non è “una funzione in più”. È codice che entra nel flusso del negozio. Se entra nel checkout, è come mettere una persona nuova alla cassa il sabato pomeriggio.

Segnali tipici:

• errore solo nel checkout;
• errore solo nel pagamento;
• errore solo nel carrello;
• errore dopo salvataggio configurazione modulo;
• errore dopo aggiornamento modulo;
• log che cita la cartella del modulo.

Non ti dico di non usare moduli. Sarebbe assurdo. Ti dico di trattarli come componenti critici, non come adesivi da attaccare al sito.

Come risolvere errore 500 PrestaShop dopo un aggiornamento?

Dopo un aggiornamento devi verificare PHP, moduli, tema, database, cache e override.

L’errore nasce spesso da una dipendenza rimasta indietro. Il vecchio e il nuovo non si parlano più.

Checklist rapida:

• il backup pre-aggiornamento esiste?
• il backup è ripristinabile?
• la versione PHP è supportata?
• il tema è compatibile?
• i moduli critici sono compatibili?
• il database ha completato le migrazioni?
• la cache è stata rigenerata?
• gli override sono ancora validi?

Io preferisco perdere tempo prima in staging, invece di perdere una giornata sul sito live. Non è prudenza da tecnico. È calcolo imprenditoriale.

Se la tua ora vale 100 euro, deve produrne 500. Se passi ore a inseguire errori casuali, il costo non è tecnico. È costo imprenditoriale.

Quando basta una correzione rapida e quando serve recupero tecnico?

Basta una correzione rapida quando la causa è isolata, recente e reversibile.

Serve recupero tecnico quando il sito è fermo, il back office non entra o l’errore coinvolge database, core, pagamento o checkout.

Puoi provare una correzione rapida se:

• hai appena installato un modulo e puoi disattivarlo;
• la cache è corrotta e puoi svuotarla;
• PHP è stato cambiato e puoi tornare indietro;
• il file .htaccess è rigenerabile;
• hai un backup recente e verificato.

Serve invece recupero tecnico se:

• front office e back office sono giù;
• il debug mostra errori multipli;
• l’aggiornamento PrestaShop si è interrotto;
• il database mostra tabelle danneggiate;
• non sai quale modifica abbia causato l’errore;
• il checkout è coinvolto;
• il sito torna online e poi ricade.

Non siamo imprenditori quando passiamo cinque ore a tentare soluzioni casuali per risparmiare un intervento tecnico. Non è un’offesa. È un dato di fatto.

Il calcolo si fa per cinque, non per tre. Se una scelta protegge vendite, tempo e dati, non è un costo. È protezione del margine.

Quanto costa intervenire su un errore 500 PrestaShop?

Il costo dipende dalla causa, ma l’intervento urgente deve partire da diagnosi, recupero e messa in sicurezza.

Per questo il Kit Recupero PrestaShop è un intervento One Shot da €697, pensato per siti down, hackerati o bloccati.

Non ti dico che ogni errore 500 PrestaShop richiede un intervento urgente. Molte volte il problema è un modulo, una cache o PHP.

Ti dico però che, quando il sito è fermo e non hai una causa chiara, ogni tentativo casuale aumenta il rischio. Puoi cancellare log utili, peggiorare permessi, sovrascrivere file o rompere redirect.

Qui serve una domanda semplice: quanto vale per te rimettere il negozio in piedi senza fare danni?

Se stai valutando anche la parte SEO e tecnica continuativa, può esserti utile leggere quando serve assistenza PrestaShop continuativa.

Come prevenire un nuovo errore 500 PrestaShop?

Prevenire significa avere backup, staging, aggiornamenti controllati, log monitorati e moduli selezionati.

Non significa non toccare mai il sito. Significa toccarlo con procedura.

Che cosa facciamo?

Metti in piedi una routine semplice:

• Backup automatici di file e database;
• Test di ripristino, perché un backup non testato è una speranza;
• Ambiente di staging per aggiornamenti e prove;
• Registro modifiche con data, ora e intervento;
• Controllo compatibilità PHP prima di aggiornare;
• Selezione moduli in base a supporto e aggiornamenti;
• Monitoraggio log dopo modifiche importanti;
• Piano di rollback prima di lavorare sul live.

Nel negozio fisico non cambi il registratore di cassa alle 18:30 del sabato. Nel digitale vale la stessa regola. Non aggiorni checkout, pagamento o tema mentre stai vendendo.

Meglio fatto che perfetto non significa fare a caso. Significa avere una procedura minima, ripetibile e concreta.

Qual è la checklist operativa per risolvere subito?

La checklist è: ultima modifica, debug, log, modulo, cache, PHP, permessi, .htaccess, memoria, database, override, hosting e core.

Questo ordine riduce le prove inutili. Quando il sito è giù, utile batte elegante.

1. Annota il momento dell’errore: ora, pagina e azione fatta.
2. Identifica l’ultima modifica: modulo, tema, PHP, hosting o aggiornamento.
3. Attiva debug: cerca l’errore reale.
4. Controlla log server: PHP, Apache/Nginx e database.
5. Disattiva il modulo sospetto: rinomina la cartella via FTP.
6. Svuota cache: soprattutto /var/cache.
7. Verifica PHP: versione ed estensioni.
8. Controlla permessi: evita soluzioni insicure.
9. Testa .htaccess: copia, rinomina e rigenera.
10. Controlla memoria: cerca errori memory exhausted.
11. Verifica database: tabelle, spazio e query lente.
12. Valuta override: soprattutto dopo aggiornamenti.
13. Controlla hosting: risorse, firewall e log PHP-FPM.
14. Verifica file core: solo con copia pulita della stessa versione.

Se dopo questi passaggi non hai una causa chiara, fermati. Continuare a toccare file live può peggiorare la situazione.

Come affrontare davvero un errore 500 PrestaShop?

Un errore 500 PrestaShop si affronta con metodo, non con tentativi casuali.

Prima trovi il segnale. Poi isoli la causa. Poi intervieni senza trasformare un problema tecnico in una settimana persa.

Non ti dico che ogni errore 500 nasconde un disastro. Molte volte è un modulo, una cache, PHP o un file .htaccess rovinato.

Ti dico però che quando il negozio è giù, il tuo compito non è “provare cose”. Il tuo compito è proteggere ordini, clienti, margine e tempo.

Se il tuo PrestaShop mostra pagina bianca, back office non accessibile, errore dopo modulo o aggiornamento, parti da questa mappa. Se vuoi evitare prove al buio, usa il Kit Recupero PrestaShop.

È un intervento One Shot da €697 pensato per emergenze su siti down, hackerati o bloccati. L’obiettivo è rimettere ordine, individuare la causa e scegliere il ripristino corretto.

Richiedi il Kit Recupero e rimetti in sicurezza il tuo PrestaShop

Domande frequenti

Posso risolvere un errore 500 PrestaShop senza tecnico?

Sì, se la causa è semplice e recente: modulo installato, cache corrotta, PHP cambiato o .htaccess danneggiato. Se però il sito è fermo, il back office non entra o il database mostra errori, meglio fermarsi e fare diagnosi tecnica.

Perché vedo errore 500 solo nel back office PrestaShop?

Di solito dipende da modulo amministrativo, cache, permessi, PHP o override. Attiva il debug da file e controlla i log prima di disattivare componenti a caso.

L’errore 500 dopo aggiornamento PrestaShop è grave?

Può esserlo, soprattutto se l’aggiornamento si è interrotto o il database non ha completato le migrazioni. Controlla backup, PHP, moduli, tema, cache e log dell’update.

Devo lasciare attivo il debug PrestaShop?

No. Il debug serve solo per diagnosticare l’errore. Dopo la correzione va disattivato, perché può mostrare informazioni tecniche sensibili a utenti e bot.

Quando conviene usare il Kit Recupero?

Conviene usarlo quando il negozio è offline, hackerato, instabile o quando non sai quale modifica abbia causato l’errore. È pensato per evitare tentativi casuali e riportare il PrestaShop sotto controllo.