Vai al contenuto

Guida completa Magento e Adobe Commerce

Email, attività pianificate e integrazioni in Magento e Adobe Commerce

In breve: Invio email, processi pianificati, code, API e servizi esterni. 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
Attività non eseguite Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log.
Dati incompleti Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log.
Errore di autenticazione Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log.
Interruzioni intermittenti Registra URL, utente, orario, risultato atteso e messaggio esatto; poi cerca la stessa evidenza nei log.
Operazioni accumulate in coda 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.

Cron

Nel contesto di Magento e Adobe Commerce, cron 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.

Attività non eseguite

Quando cron non esegue le attività previste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Dati incompleti

Quando cron invia dati incompleti, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Errore di autenticazione

Quando cron restituisce errori di autenticazione, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Interruzioni intermittenti

Quando cron si interrompe in modo intermittente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Operazioni accumulate in coda

Quando cron accumula operazioni in coda, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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 consumer delle code

Nel contesto di Magento e Adobe Commerce, i consumer delle code 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.

Attività non eseguite

Quando i consumer delle code non esegue le attività previste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Dati incompleti

Quando i consumer delle code invia dati incompleti, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Errore di autenticazione

Quando i consumer delle code restituisce errori di autenticazione, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Interruzioni intermittenti

Quando i consumer delle code si interrompe in modo intermittente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Operazioni accumulate in coda

Quando i consumer delle code accumula operazioni in coda, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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 email

Nel contesto di Magento e Adobe Commerce, le email 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.

Attività non eseguite

Quando le email non esegue le attività previste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Dati incompleti

Quando le email invia dati incompleti, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Errore di autenticazione

Quando le email restituisce errori di autenticazione, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Interruzioni intermittenti

Quando le email si interrompe in modo intermittente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Operazioni accumulate in coda

Quando le email accumula operazioni in coda, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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 e REST

Nel contesto di Magento e Adobe Commerce, GraphQL e 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.

Attività non eseguite

Quando GraphQL e REST non esegue le attività previste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Dati incompleti

Quando GraphQL e REST invia dati incompleti, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Errore di autenticazione

Quando GraphQL e REST restituisce errori di autenticazione, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Interruzioni intermittenti

Quando GraphQL e REST si interrompe in modo intermittente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Operazioni accumulate in coda

Quando GraphQL e REST accumula operazioni in coda, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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 callback di pagamento

Nel contesto di Magento e Adobe Commerce, le callback di pagamento 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.

Attività non eseguite

Quando le callback di pagamento non esegue le attività previste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Dati incompleti

Quando le callback di pagamento invia dati incompleti, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Errore di autenticazione

Quando le callback di pagamento restituisce errori di autenticazione, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Interruzioni intermittenti

Quando le callback di pagamento si interrompe in modo intermittente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Operazioni accumulate in coda

Quando le callback di pagamento accumula operazioni in coda, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Importazioni ed esportazioni

Nel contesto di Magento e Adobe Commerce, importazioni ed esportazioni 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.

Attività non eseguite

Quando importazioni ed esportazioni non esegue le attività previste, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Dati incompleti

Quando importazioni ed esportazioni invia dati incompleti, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Errore di autenticazione

Quando importazioni ed esportazioni restituisce errori di autenticazione, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Interruzioni intermittenti

Quando importazioni ed esportazioni si interrompe in modo intermittente, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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.

Operazioni accumulate in coda

Quando importazioni ed esportazioni accumula operazioni in coda, il sintomo non basta per scegliere la correzione. Su Magento e Adobe Commerce conviene prima seguire il flusso dalla generazione dell’evento fino alla sua esecuzione, consegna o conferma da parte del servizio esterno. 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. Identificare evento, payload, destinatario e timestamp

    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. Verificare che l’attività sia stata creata e poi eseguita

    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. Controllare log applicativi e risposta del servizio esterno

    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. Validare credenziali, token, firma e scadenza

    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. Testare DNS, rete e firewall dal server

    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. Simulare un caso controllato senza coinvolgere dati reali

    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.

  • cron 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 email, attività pianificate e integrazioni 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