Guida completa PrestaShop
Errori e sito non raggiungibile in PrestaShop
In breve: Errori HTTP, pagine bianche, eccezioni e blocchi che impediscono al sito di rispondere. Questa guida riunisce i casi che prima erano distribuiti in trenta URL molto simili e li organizza in un unico percorso diagnostico verificabile.
Ambito e componenti da controllare
Il sintomo visibile è soltanto il punto di partenza. Prima di modificare PrestaShop, separa applicazione, estensioni, tema, database, cache, web server e servizi esterni. Cambia una variabile per volta e conserva sempre l’evidenza che conferma o esclude un livello.
Sintomi ed evidenze da raccogliere
| Sintomo | Prima evidenza utile |
|---|---|
| Errore 500 | Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log. |
| Pagina bianca | Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log. |
| Caricamento infinito | Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log. |
| Funzionamento parziale | Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log. |
| Blocco dopo una modifica | Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log. |
Diagnosi per componente
Ogni componente può produrre sintomi simili. Le schede seguenti indicano cosa significa ciascun caso e quale prova raccogliere prima della correzione.
Il front office
Nel contesto di PrestaShop, il front office partecipa a un flusso più ampio. Assistenza PrestaShop per front office, back office, checkout, moduli, catalogo, prestazioni, sicurezza e migrazioni. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel back office di PrestaShop, nei processi pianificati e nei servizi collegati.
Errore 500
Quando il front office presenta un errore 500, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Pagina bianca
Quando il front office mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Caricamento infinito
Quando il front office rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Funzionamento parziale
Quando il front office funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Blocco dopo una modifica
Quando il front office si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Il back office
Nel contesto di PrestaShop, il back office partecipa a un flusso più ampio. Assistenza PrestaShop per front office, back office, checkout, moduli, catalogo, prestazioni, sicurezza e migrazioni. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel back office di PrestaShop, nei processi pianificati e nei servizi collegati.
Errore 500
Quando il back office presenta un errore 500, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Pagina bianca
Quando il back office mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Caricamento infinito
Quando il back office rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Funzionamento parziale
Quando il back office funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Blocco dopo una modifica
Quando il back office si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Il checkout
Nel contesto di PrestaShop, il checkout partecipa a un flusso più ampio. Assistenza PrestaShop per front office, back office, checkout, moduli, catalogo, prestazioni, sicurezza e migrazioni. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel back office di PrestaShop, nei processi pianificati e nei servizi collegati.
Errore 500
Quando il checkout presenta un errore 500, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Pagina bianca
Quando il checkout mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Caricamento infinito
Quando il checkout rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Funzionamento parziale
Quando il checkout funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Blocco dopo una modifica
Quando il checkout si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Le pagine prodotto
Nel contesto di PrestaShop, le pagine prodotto partecipa a un flusso più ampio. Assistenza PrestaShop per front office, back office, checkout, moduli, catalogo, prestazioni, sicurezza e migrazioni. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel back office di PrestaShop, nei processi pianificati e nei servizi collegati.
Errore 500
Quando le pagine prodotto presenta un errore 500, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Pagina bianca
Quando le pagine prodotto mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Caricamento infinito
Quando le pagine prodotto rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Funzionamento parziale
Quando le pagine prodotto funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Blocco dopo una modifica
Quando le pagine prodotto si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Il carrello
Nel contesto di PrestaShop, il carrello partecipa a un flusso più ampio. Assistenza PrestaShop per front office, back office, checkout, moduli, catalogo, prestazioni, sicurezza e migrazioni. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel back office di PrestaShop, nei processi pianificati e nei servizi collegati.
Errore 500
Quando il carrello presenta un errore 500, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Pagina bianca
Quando il carrello mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Caricamento infinito
Quando il carrello rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Funzionamento parziale
Quando il carrello funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Blocco dopo una modifica
Quando il carrello si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Il webservice
Nel contesto di PrestaShop, il webservice partecipa a un flusso più ampio. Assistenza PrestaShop per front office, back office, checkout, moduli, catalogo, prestazioni, sicurezza e migrazioni. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel back office di PrestaShop, nei processi pianificati e nei servizi collegati.
Errore 500
Quando il webservice presenta un errore 500, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Pagina bianca
Quando il webservice mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Caricamento infinito
Quando il webservice rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Funzionamento parziale
Quando il webservice funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Blocco dopo una modifica
Quando il webservice si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su PrestaShop conviene prima stabilire dove si interrompe la richiesta: DNS, web server, PHP, bootstrap dell’applicazione, database o rendering finale. La prima evidenza utile è il messaggio registrato nei log nello stesso momento della richiesta, insieme alla versione del CMS, di PHP e dei componenti modificati di recente.
Percorso diagnostico in ordine
Esegui i controlli dal meno invasivo al più profondo. Un tentativo è utile solo se ha un risultato atteso, produce un’evidenza e può essere annullato.
-
Riprodurre l’errore su un URL preciso e annotare orario e codice HTTP
Esegui questo controllo su un caso preciso e annota il risultato. Se l’evidenza cambia, ripeti la richiesta nelle stesse condizioni per evitare che cache, sessioni o dati differenti falsino il confronto.
-
Controllare log applicativi, PHP e web server cercando la prima eccezione
Esegui questo controllo su un caso preciso e annota il risultato. Se l’evidenza cambia, ripeti la richiesta nelle stesse condizioni per evitare che cache, sessioni o dati differenti falsino il confronto.
-
Verificare spazio, inode, memoria, processi e stato del database
Esegui questo controllo su un caso preciso e annota il risultato. Se l’evidenza cambia, ripeti la richiesta nelle stesse condizioni per evitare che cache, sessioni o dati differenti falsino il confronto.
-
Confrontare i file modificati di recente con una copia affidabile
Esegui questo controllo su un caso preciso e annota il risultato. Se l’evidenza cambia, ripeti la richiesta nelle stesse condizioni per evitare che cache, sessioni o dati differenti falsino il confronto.
-
Disattivare in staging il componente sospetto con un test reversibile
Esegui questo controllo su un caso preciso e annota il risultato. Se l’evidenza cambia, ripeti la richiesta nelle stesse condizioni per evitare che cache, sessioni o dati differenti falsino il confronto.
-
Verificare che il sito risponda anche senza cache e CDN
Esegui questo controllo su un caso preciso e annota il risultato. Se l’evidenza cambia, ripeti la richiesta nelle stesse condizioni per evitare che cache, sessioni o dati differenti falsino il confronto.
Strumenti e percorsi utili in PrestaShop
- Controlla i log applicativi in
var/logs/e i log PHP/web server nello stesso intervallo del problema. - Esegui
php bin/console listdalla root del progetto per verificare i comandi disponibili nella versione installata. - Prima di intervenire su moduli, override o tema, documenta modalità debug, cache, versione PHP e ultimo deploy.
Verifica finale e rollback
Il ritorno della pagina non basta a chiudere l’intervento. Ripeti il caso iniziale, un caso di controllo e i flussi collegati; poi verifica che non siano comparsi nuovi errori.
- il front office nel caso che generava il problema e in un secondo caso di controllo
- frontend e area amministrativa con utenti e permessi differenti
- salvataggio dei dati e assenza di nuovi errori nei log
- email, attività pianificate, API, code o callback coinvolte
- cache e CDN dopo la riattivazione
- prestazioni, consumo risorse e stabilità per un intervallo adeguato
- backup aggiornato e documentazione della modifica
Riferimenti ufficiali
I percorsi e i comandi possono cambiare tra versioni. Prima di intervenire, confronta la procedura con la documentazione della versione installata e conserva un rollback verificato.
Domande frequenti
Da quale controllo partire per errori e sito non raggiungibile in PrestaShop?
Parti da un caso riproducibile e dal log registrato nello stesso orario. Versioni, ultima modifica, URL, utente e risultato atteso permettono di distinguere un errore applicativo da cache, infrastruttura o servizi esterni.
È sufficiente svuotare la cache?
No. La cache è un livello da verificare, ma non corregge file mancanti, dipendenze incompatibili, dati incoerenti o configurazioni errate. Usala come test e annota quale livello ha restituito la risposta.
Quando serve un ambiente di staging?
Quando la correzione può influire su utenti, ordini, contenuti, permessi o configurazioni. Lo staging deve rappresentare il caso reale senza esporre dati personali e deve avere un piano di riallineamento con la produzione.
Quali informazioni preparare prima di chiedere assistenza?
Prepara URL, messaggio, orario, versione di PrestaShop, versione PHP e database, modifiche recenti, accessi disponibili e un estratto pertinente dei log. Non inviare password nel primo messaggio.
Quando è preferibile un rollback?
Quando il ripristino del servizio è prioritario e la modifica può essere annullata senza perdere dati recenti. Prima confronta file e database del backup con lo stato corrente e conserva separatamente ordini, utenti o contenuti creati dopo la copia.
Serve una diagnosi sul tuo sito?
Se il problema riguarda un’installazione reale, prepara versione, URL, orario, modifiche recenti e log pertinenti.