Errore 500 PrestaShop: Cause, Controlli e Come Risolverlo

Hai un errore 500 su PrestaShop e il sito è bloccato?

Se il tuo shop mostra errore 500, pagina bianca o non riesci più ad accedere correttamente al sito, posso aiutarti a fare una verifica tecnica.

Per problemi semplici puoi richiedere un fix rapido PrestaShop. Se il sito è offline, il checkout è bloccato o stai perdendo ordini, è meglio partire da un intervento di assistenza PrestaShop urgente.

Quando gestisci un negozio online con PrestaShop può capitare di incappare in errori tecnici, bug o schermate improvvise che bloccano il sito. Uno dei problemi più comuni è l’errore 500 PrestaShop, chiamato anche Internal Server Error.

L’errore 500 è fastidioso perché spesso non mostra subito la causa precisa. Può dipendere da PHP, permessi dei file, moduli, tema, configurazioni server, cache, file .htaccess, database o aggiornamenti non andati a buon fine.

In questa guida vediamo:

• che cos’è l’errore 500;
• dove controllare i log;
• come attivare la modalità debug;
• quali sono le cause più comuni;
• quali controlli fare prima di intervenire;
• quando è meglio chiedere assistenza tecnica PrestaShop.

Se hai un ecommerce attivo e non sai dove mettere le mani, evita modifiche casuali: un intervento sbagliato può peggiorare il problema o rendere più difficile il ripristino.

Che cos’è l’errore 500 in PrestaShop

Un errore 500 è una segnalazione generica di problema lato server. Significa che il server ha incontrato un errore durante l’elaborazione della richiesta, ma non riesce a mostrare una spiegazione chiara all’utente.

In PrestaShop l’errore 500 può comparire:

• nel frontend del sito;
• nel back office;
• durante il checkout;
• dopo aver installato o aggiornato un modulo;
• dopo aver cambiato versione PHP;
• dopo modifiche al tema;
• dopo una migrazione o aggiornamento a nuove versioni di prestashop;
• dopo modifiche al file .htaccess;
• dopo problemi di permessi su file e cartelle.

Spesso il problema è legato a PHP, perché PrestaShop utilizza PHP per eseguire gran parte delle sue funzioni. Se uno script genera un errore grave, il server può restituire una pagina 500 o una schermata bianca.

Prima cosa da fare: non modificare tutto a caso

Quando compare un errore 500, la tentazione è provare subito a svuotare cache, disattivare moduli, cambiare file o modificare impostazioni. In alcuni casi può funzionare, ma in altri può peggiorare la situazione.

Prima di intervenire:

• segna data e ora in cui è comparso l’errore;
• chiediti cosa è stato modificato subito prima;
• controlla se è stato aggiornato un modulo;
• verifica se l’hosting ha cambiato versione PHP;
• controlla se sono state fatte modifiche al tema;
• verifica se il problema riguarda tutto il sito o solo una pagina;
• se possibile, fai un backup prima di toccare file o database.

Queste informazioni sono importanti anche se decidi di richiedere assistenza.

Dove si trova il file error_log del server

Per capire la causa reale dell’errore 500 bisogna leggere il file di log del server, spesso chiamato error_log.

Di solito il file error_log può trovarsi:

• nella cartella principale del sito;
• in una cartella chiamata logs;
• nel pannello hosting;
• nel pannello cPanel, Plesk o simili;
• nella sezione errori PHP o errori server dell’hosting.

Ogni hosting può gestire i log in modo diverso. Se non riesci a trovare il file, puoi chiedere al supporto hosting dove leggere gli errori PHP o gli errori server del tuo dominio.

Come leggere l’errore specifico nel file error_log

Gli errori nei log sono registrati per data e ora. Questo ti aiuta a individuare il messaggio corretto.

Per procedere:

1. riproduci l’errore sul sito;
2. annota l’orario;
3. apri il file error_log;
4. cerca le righe generate in quel momento;
5. copia il messaggio di errore più recente;
6. verifica se il messaggio cita un file, un modulo, una classe, una funzione o una cartella.

Esempi di segnali utili:

• nome di un modulo;
• percorso di un file PHP;
• errore di memoria;
• errore di permessi;
• errore database;
• classe non trovata;
• incompatibilità con versione PHP;
• errore nel tema o in un override.

Una volta individuato il messaggio, è molto più semplice capire se il problema è risolvibile con un fix rapido o se richiede un intervento urgente.

Attivare la modalità debug in PrestaShop

Per vedere un messaggio di errore più preciso puoi attivare la modalità debug di PrestaShop.

Attenzione: la modalità debug può mostrare informazioni tecniche sensibili. Usala solo per il tempo necessario alla diagnosi e disattivala appena finito il controllo.

Attivare debug dal back office

Se riesci ad accedere al back office:

1. vai su Impostazioni avanzate;
2. entra in Prestazioni;
3. cerca la voce Modalità debug;
4. impostala su Sì;
5. salva;
6. ricarica la pagina che mostra errore 500.

Il messaggio di errore potrebbe mostrare più dettagli, ad esempio un problema di database, un modulo, un file mancante o un errore PHP.

Attivare debug via FTP

Se non riesci ad accedere al back office, puoi attivare il debug via FTP.

Collegati al server e apri il file:

Cerca questa riga:

e sostituiscila con:

Salva il file e ricarica la pagina.

Quando hai finito il controllo, ricordati di riportare il valore a:

Cause comuni dell’errore 500 in PrestaShop

L’errore 500 può dipendere da molte cause. Qui trovi le più frequenti.

1. Permessi errati su file e cartelle

Una delle cause più comuni riguarda i permessi di file e cartelle.

Permessi troppo restrittivi possono impedire a PrestaShop di leggere o scrivere file necessari. Permessi troppo aperti, come 777, possono invece creare rischi di sicurezza.

In molti casi i permessi corretti sono simili a:

• cartelle: 755;
• file: 644.

Questi valori però possono cambiare in base all’hosting. Prima di modificare permessi in massa, verifica le indicazioni del provider.

2. File .htaccess danneggiato o configurato male

Il file .htaccess gestisce redirect, URL riscritti e regole lato server. Una riga sbagliata può causare errore 500.

In PrestaShop il problema può comparire dopo:

• attivazione URL friendly;
• modifiche manuali al file .htaccess;
• migrazione dominio;
• cambio SSL;
• plugin o moduli che modificano regole;
• redirect scritti male.

Prima di modificare il file, crea una copia di sicurezza.

In alcuni casi puoi rigenerare .htaccess dal back office disattivando e riattivando URL friendly, ma fallo solo se sai cosa stai modificando.

3. Modulo PrestaShop incompatibile o rotto

Un modulo può generare errore 500 se:

• non è compatibile con la versione di PrestaShop;
• non è compatibile con la versione PHP;
• è stato aggiornato male;
• contiene un errore nel codice;
• entra in conflitto con tema o altri moduli;
• modifica hook o override in modo errato.

Se l’errore è comparso subito dopo aver installato o aggiornato un modulo, parti da lì.

4. Problemi con PHP 8 o versione PHP non compatibile

Molti shop PrestaShop hanno problemi dopo un cambio versione PHP. Alcuni moduli o temi vecchi non sono compatibili con PHP 8 o versioni successive.

Sintomi comuni:

• pagina bianca;
• errore 500;
• back office non accessibile;
• modulo che smette di funzionare;
• checkout bloccato;
• errori di classe, funzione o sintassi.

Controlla sempre la compatibilità tra:

• versione PrestaShop;
• versione PHP;
• moduli installati;
• tema;
• override personalizzati.

5. Cache corrotta o file temporanei

La cache può causare comportamenti strani, specialmente dopo aggiornamenti o modifiche.

Puoi provare a:

• svuotare cache dal back office;
• cancellare cache da hosting;
• pulire cache del tema;
• verificare eventuale cache server-side;
• disattivare temporaneamente ottimizzazioni aggressive.

Se però il sito è completamente offline, evita tentativi casuali senza backup.

6. Timeout o limite risorse server

Alcuni script possono richiedere più tempo o memoria del previsto. Se il server interrompe l’esecuzione, può comparire errore 500.

Succede spesso durante:

• importazioni CSV;
• backup;
• rigenerazione immagini;
• caricamento traduzioni;
• import/export;
• aggiornamenti;
• operazioni massive su prodotti o categorie.

In questi casi può essere necessario aumentare temporaneamente:

• max_execution_time;
• memory_limit;
• post_max_size;
• upload_max_filesize;
• risorse hosting.

7. Problemi database

PrestaShop può mostrare errore 500 se non riesce a connettersi correttamente al database o se alcune tabelle hanno problemi.

Possibili cause:

• credenziali database errate;
• database non raggiungibile;
• tabella danneggiata;
• migrazione incompleta;
• prefisso tabelle errato;
• errore dopo update o importazione.

Un messaggio tipico può essere collegato a problemi di connessione al database.

8. Tema o override con errori

Tema e override possono generare errore 500 se contengono codice non compatibile, file mancanti o modifiche errate.

Controlla se l’errore è comparso dopo:

• modifica al tema;
• aggiornamento del tema;
• installazione modulo che modifica template;
• modifica override;
• intervento su file .tpl, .php, .js.

Cosa fare se l’errore 500 compare dopo un aggiornamento

Se l’errore 500 appare dopo un aggiornamento di PrestaShop, di un modulo o del tema:

1. controlla i log;
2. verifica la versione PHP;
3. controlla il modulo aggiornato;
4. svuota cache;
5. verifica override e tema;
6. controlla permessi file;
7. se disponibile, ripristina backup o staging;
8. evita di aggiornare altri moduli prima di capire la causa.

Gli aggiornamenti andrebbero sempre testati prima in ambiente di staging, soprattutto su ecommerce attivi.

Cosa fare se l’errore 500 compare nel checkout

Se l’errore 500 compare durante il checkout, il problema è più urgente perché può bloccare gli ordini.

Le cause possono essere:

• modulo pagamento;
• modulo spedizione;
• tema;
• override checkout;
• errore JavaScript;
• problema PHP;
• problema di configurazione carrello;
• incompatibilità tra moduli;
• cache o ottimizzazione script.

In questo caso non limitarti a controllare la pagina: testa tutto il percorso di acquisto, dal carrello alla conferma ordine.

Se il checkout è bloccato, meglio richiedere assistenza PrestaShop urgente.

Cosa fare se l’errore 500 compare nel back office

Se l’errore 500 compare nel back office, potresti non riuscire a gestire ordini, prodotti o moduli.

Controlla:

• ultimo modulo installato;
• aggiornamenti recenti;
• versione PHP;
• errori nel log server;
• permessi file;
• cache;
• eventuali override;
• spazio disco hosting;
• configurazioni server.

Se non riesci più ad accedere al pannello, può essere necessario intervenire via FTP, hosting o database.

Quando puoi provare da solo

Puoi provare a gestire il problema da solo se:

• hai backup aggiornato;
• sai accedere via FTP;
• sai leggere il file error_log;
• conosci la struttura di PrestaShop;
• sai ripristinare un file modificato;
• il sito non sta perdendo ordini in quel momento.

Puoi provare controlli semplici come:

• leggere log;
• svuotare cache;
• verificare ultimo modulo installato;
• controllare versione PHP;
• controllare permessi;
• disattivare debug dopo il test.

Quando chiedere assistenza tecnica

Ti conviene chiedere assistenza se:

• il sito è offline;
• il checkout non funziona;
• hai errore 500 dopo aggiornamento;
• il back office non è accessibile;
• non trovi il file error_log;
• il messaggio di errore cita codice, classi o database;
• non hai backup;
• non sai quale modulo ha causato il problema;
• stai perdendo ordini o campagne attive.

In questi casi una diagnosi rapida può evitare perdite di tempo e ridurre il rischio di peggiorare il problema.

Errore 500 o errore di reindirizzamento?

L’errore 500 non va confuso con l’errore di reindirizzamento, come ERR_TOO_MANY_REDIRECTS.

L’errore 500 indica un problema lato server o applicativo.

L’errore di reindirizzamento invece riguarda spesso:

• configurazione SSL;
• URL negozio;
• dominio shop e dominio SSL;
• redirect errati;
• cache;
• configurazione database.

Se il tuo problema è un loop di redirect, puoi leggere la guida dedicata.

FAQ errore 500 PrestaShop

Che cos’è l’errore 500 in PrestaShop?

L’errore 500 è un errore generico lato server. In PrestaShop può dipendere da PHP, moduli, tema, permessi, cache, file .htaccess, database, hosting o aggiornamenti.

Come faccio a capire la causa dell’errore 500?

Il modo migliore è controllare il file error_log del server e, se necessario, attivare temporaneamente la modalità debug di PrestaShop.

Posso risolvere da solo un errore 500 PrestaShop?

Dipende dalla causa. Se hai competenze tecniche, accessi FTP, backup e sai leggere i log, puoi fare alcuni controlli. Se il sito è online e vende, evita modifiche casuali.

L’errore 500 può dipendere da un modulo?

Sì. Un modulo incompatibile, aggiornato male o in conflitto con tema e altri moduli può generare errore 500.

L’errore 500 può dipendere da PHP 8?

Sì. Se PrestaShop, tema o moduli non sono compatibili con la versione PHP usata dall’hosting, possono comparire errori 500, pagine bianche o blocchi del back office.

Cosa faccio se il checkout mostra errore 500?

Se il checkout mostra errore 500, è un problema urgente perché può bloccare gli ordini. Controlla log, modulo pagamento, tema, override e JavaScript. Se non sai intervenire, richiedi assistenza.

Quanto costa risolvere un errore 500 PrestaShop?

Dipende dalla causa. Un controllo o fix semplice può partire da 49€. Se il sito è offline, il checkout è bloccato o il problema è urgente, l’assistenza tecnica parte da 99€.

Devo fare backup prima di intervenire?

Sì. Prima di modificare file, moduli, tema o database è sempre consigliato avere un backup aggiornato.