Annota l’indirizzo esatto, l’ora con il fuso orario e l’azione dopo la quale è comparso l’errore. Queste tre informazioni permettono di cercare lo stesso evento nei log. Il solo numero 500 o 522 non indica ancora il modulo da modificare.

Questa guida aiuta a preparare una segnalazione per la diagnosi. Non descrive la riparazione di un negozio specifico né presenta cause di esempio come risultato accertato.

Cosa annotare durante il guasto?

  1. Indirizzo e azione: ad es. apertura del prodotto, salvataggio di un’impostazione nel pannello oppure passaggio dal carrello alla consegna. Non annotare in una segnalazione pubblica i token presenti nell’indirizzo del pannello.
  2. Ora: data, ora e fuso, ad es. 2026-09-26 14:32 Europe/Warsaw. Se il problema si ripresenta, annota due o tre occorrenze concrete.
  3. Risposta: codice HTTP, messaggio visibile e identificatore della richiesta, se la pagina di errore lo fornisce. Completa lo screenshot con il testo del messaggio.
  4. Ambito: un solo indirizzo o l’intero negozio, frontend o pannello, utente autenticato o ospite, una rete o anche un’altra.
  5. Ultima modifica: aggiornamento, installazione di un modulo, importazione, modifica di un’impostazione dell’hosting. Indica la data; il solo ordine degli eventi non dimostra la causa.

Errore 500 ed errore 522 richiedono punti di partenza diversi

Cosa si può dedurre dalla risposta prima di consultare i log
RispostaDa dove iniziareCosa non si sa ancora
HTTP 500Confronta l’ora e il percorso con il log dell’applicazione e del server che gestisce la richiesta.Il codice non identifica da solo il modulo, la query o l’impostazione PHP. Guasti diversi possono restituire lo stesso stato.
Cloudflare 522Verifica la connessione tra Cloudflare e il server di origine. Annota il Ray ID, se è visibile, e comunica l’orario all’hosting.Il solo codice non conferma un errore di PrestaShop. L’origine può essere, tra l’altro, l’indisponibilità o il sovraccarico del server oppure il blocco delle connessioni.
Pagina vuota senza stato registratoVerifica la risposta del documento principale negli strumenti del browser; conserva l’indirizzo e l’ora.Non è ancora chiaro se il problema riguardi la risposta del server, uno script nel browser o una risorsa necessaria per visualizzare la pagina.

Descrizione del 522 e raccomandazioni per la connessione con il server di origine: documentazione Cloudflare. Significato generale dello stato 500: HTTP Semantics, RFC 9110.

Come preparare una semplice prova di riproduzione?

Esempio dimostrativo di segnalazione: “Alle 14:32 apro la scheda prodotto come ospite. Il documento ha stato 500. La home page nello stesso browser funziona. Alle 14:35 lo stesso prodotto funziona da un’altra rete”. Una nota di questo tipo non diagnostica la causa, ma indica richieste concrete da confrontare.

A ogni ripetizione cambia una sola condizione e annota il risultato. Se contemporaneamente svuoti la cache, cambi PHP e disattivi diversi moduli, sarà difficile stabilire quale modifica abbia influito sul comportamento del negozio.

Quali log trasmettere alla persona che effettua la diagnosi?

Chiedi di verificare un breve intervallo di tempo attorno all’evento: il log dell’applicazione, gli errori PHP e del server WWW e, in presenza di un livello intermedio, anche i suoi eventi. La posizione di salvataggio dei log dipende dalla versione del negozio e dalla configurazione dell’hosting. Invece di presumere un percorso, fornisci all’amministratore l’ora esatta, l’indirizzo e il metodo della richiesta, se lo conosci.

I frammenti di log possono contenere indirizzi e-mail, identificatori di sessione e dati degli ordini. Trasmetti l’estratto necessario tramite un canale concordato e rimuovi i segreti. Anche un file HAR completo può contenere tali informazioni; non pubblicarlo come semplice allegato su un forum.

Come confrontare i livelli senza modificare la protezione dell’intero negozio?

Il confronto delle risposte tramite CDN e direttamente dal server dovrebbe essere preparato da un amministratore che conosca la configurazione del dominio, del TLS e dell’accesso all’origin. La differenza tra le risposte è un’indicazione per ulteriori test, non una prova automatica della responsabilità del WAF o di PrestaShop.

Usa la modalità di debug su una copia di lavoro o in un accesso controllato. La disattivazione globale della protezione oppure la visualizzazione di eccezioni dettagliate a tutti i visitatori non è necessaria per redigere una segnalazione utile.

Modello di segnalazione pronto da scaricare

Scarica il modulo di descrizione del guasto — TXT. Compila i campi e contrassegna l’informazione mancante con “non verificato”. Il modulo non richiede password né chiavi API.

Cosa verificare dopo la correzione?

Ripeti i passaggi annotati nelle stesse condizioni, verifica il risultato dell’operazione e le nuove voci nei log. In caso di problema sporadico, una sola apertura corretta della pagina conferma solo quel tentativo. Concorda con l’esecutore il periodo di osservazione, l’ambito dei test e il segnale per una nuova segnalazione.

Se il problema è comparso durante un cambio di versione, utilizza anche la lista di preparazione all’aggiornamento di PrestaShop. Una guida separata spiega il ruolo delle intestazioni di sicurezza HTTP.

Vedi gli articoli dell'autore
Patryk Marek

Patryk Marek — proprietario di PrestaDev.pl e sviluppatore specializzato in PrestaShop. Da molti anni si occupa della creazione, dello sviluppo e della manutenzione di negozi online. Unisce il lavoro sul codice del negozio e dei moduli alla configurazione dell’ambiente server in cui queste soluzioni operano.

Progetta e sviluppa moduli PrestaShop, adatta le funzionalità esistenti e prepara integrazioni con grossisti e servizi esterni. Lavora sull’importazione e sull’aggiornamento dei dati dei prodotti, sull’automazione della gestione del catalogo, sul processo dell’ordine e sugli strumenti che supportano il lavoro quotidiano del proprietario del negozio.

La sua esperienza comprende anche aggiornamenti e migrazioni dei negozi, diagnosi degli errori, analisi delle prestazioni e configurazione dei server e dei servizi necessari al funzionamento di PrestaShop. Nella risoluzione dei problemi tiene conto delle dipendenze tra moduli, tema, PHP, database e impostazioni di hosting.

Nel blog condivide conoscenze derivanti da molti anni di pratica nello sviluppo e dal lavoro con il backend tecnico dei negozi. Le guide si concentrano su problemi concreti, sui modi per verificarli e sui limiti delle soluzioni descritte. Aiutano i proprietari dei negozi e le figure tecniche a preparare le modifiche, valutarne la portata e verificarne il risultato.

Commenti (0)

Nessun commento in questo momento

Nuovo commento

Stai rispondendo a un commento