Vai al contenuto

Guida completa Magento e Adobe Commerce

Errori e sito non raggiungibile in Magento e Adobe Commerce

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 Magento e Adobe Commerce, 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.

Lo storefront

Nel contesto di Magento e Adobe Commerce, lo storefront partecipa a un flusso più ampio. Assistenza Magento e Adobe Commerce su catalogo, checkout, Composer, cron, indexer, cache, OpenSearch, code e infrastruttura. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel pannello Admin di Magento o Adobe Commerce, nei processi pianificati e nei servizi collegati.

Errore 500

Quando lo storefront presenta un errore 500, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 lo storefront mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 lo storefront rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 lo storefront funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 lo storefront si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 pannello Admin

Nel contesto di Magento e Adobe Commerce, il pannello Admin partecipa a un flusso più ampio. Assistenza Magento e Adobe Commerce su catalogo, checkout, Composer, cron, indexer, cache, OpenSearch, code e infrastruttura. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel pannello Admin di Magento o Adobe Commerce, nei processi pianificati e nei servizi collegati.

Errore 500

Quando il pannello Admin presenta un errore 500, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 pannello Admin mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 pannello Admin rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 pannello Admin funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 pannello Admin si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 Magento e Adobe Commerce, il checkout partecipa a un flusso più ampio. Assistenza Magento e Adobe Commerce su catalogo, checkout, Composer, cron, indexer, cache, OpenSearch, code e infrastruttura. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel pannello Admin di Magento o Adobe Commerce, 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 Magento e Adobe Commerce 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 Magento e Adobe Commerce 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 Magento e Adobe Commerce 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 Magento e Adobe Commerce 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 Magento e Adobe Commerce 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.

GraphQL o REST

Nel contesto di Magento e Adobe Commerce, GraphQL o REST partecipa a un flusso più ampio. Assistenza Magento e Adobe Commerce su catalogo, checkout, Composer, cron, indexer, cache, OpenSearch, code e infrastruttura. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel pannello Admin di Magento o Adobe Commerce, nei processi pianificati e nei servizi collegati.

Errore 500

Quando GraphQL o REST presenta un errore 500, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 GraphQL o REST mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 GraphQL o REST rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 GraphQL o REST funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 GraphQL o REST si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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.

I contenuti statici

Nel contesto di Magento e Adobe Commerce, i contenuti statici partecipa a un flusso più ampio. Assistenza Magento e Adobe Commerce su catalogo, checkout, Composer, cron, indexer, cache, OpenSearch, code e infrastruttura. Per questo è necessario osservare non soltanto la pagina finale, ma anche ciò che accade nel pannello Admin di Magento o Adobe Commerce, nei processi pianificati e nei servizi collegati.

Errore 500

Quando i contenuti statici presenta un errore 500, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 i contenuti statici mostra una pagina bianca, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 i contenuti statici rimane in caricamento senza completare la risposta, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 i contenuti statici funziona solo per alcune pagine o richieste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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 i contenuti statici si blocca dopo una modifica recente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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 Magento

  • Esegui bin/magento --version e bin/magento deploy:mode:show per registrare versione e modalità.
  • Controlla var/log/, var/report/ e i log dei servizi collegati nello stesso timestamp della richiesta.
  • Verifica in modo mirato bin/magento cache:status, bin/magento indexer:status e lo stato dei cron.
Attenzione: comandi, percorsi e nomi dei menu cambiano tra versioni e ambienti. Verifica sempre la documentazione della versione installata e non eseguire comandi distruttivi senza backup.

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.

  • lo storefront 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 Magento?

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 Magento e Adobe Commerce, 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.

Assistenza Magento Invia i dettagli del problema