Aggiornamento PrestaShop fallito? Ecco cosa fare

Come riconoscere un aggiornamento fallito

• Errore 500 dopo l’aggiornamento
• Front-end o back office irraggiungibili
• Pagina bianca (white screen)
• Layout o moduli sballati
• Messaggi d’errore durante l’upgrade

Cause più frequenti degli errori di aggiornamento

• Moduli non compatibili con la nuova versione
• Temi personalizzati che non supportano le nuove funzioni
• Cache non svuotata prima/dopo l’aggiornamento
• Errore durante la migrazione del database
• Timeout server o limiti di memoria PHP

Come risolvere e aggiornare PrestaShop in modo sicuro

1. Ripristina un backup

Se hai un backup funzionante, è la strada più veloce per recuperare tutto e riprovare l’aggiornamento in modo controllato.

2. Attiva la modalità debug

Modifica config/defines.inc.php per visualizzare gli errori reali:

define('_PS_MODE_DEV_', true);

3. Svuota la cache manualmente

Cancella il contenuto delle cartelle:
var/cache/dev e var/cache/prod

4. Controlla il tema attivo

Passa temporaneamente a un tema nativo (es. Classic) per capire se il problema viene dal tema.

5. Rimuovi o disattiva moduli non compatibili

Via FTP, rinomina le cartelle dei moduli installati recentemente o potenzialmente non compatibili.

6. Usa 1-Click Upgrade correttamente

Assicurati di:

• Essere in modalità manutenzione
• Aver fatto backup file e database
• Usare l’ultima versione stabile del modulo `autoupgrade`

Come evitare problemi con gli aggiornamenti futuri

• Testa sempre l’upgrade in ambiente di staging
• Fai backup completo prima di aggiornare
• Aggiorna prima i moduli e poi il core
• Verifica compatibilità di tema e moduli
• Controlla le note di rilascio prima dell’update