AEM non può inviare e-mail SMTP in uscita a causa di una configurazione errata del servizio di posta o delle reti avanzate

Ultimo aggiornamento: 2 luglio 2026

Negli ambienti AEM non è possibile inviare messaggi e-mail in uscita. Nei registri vengono visualizzati errori di connessione SMTP, ad esempio EmailException o MailConnectException, e messaggi e-mail che funzionano localmente ma non funzionano in AEM as a Cloud Service. Per risolvere il problema, verifica il tipo di ambiente, correggi il servizio di posta e la configurazione di rete avanzata e convalida la connettività SMTP nei registri.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service
AEM Managed Services
Adobe Experience Manager 6.5 (locale)
AEM Forms

Problema/Sintomi

I registri mostrano un errore di invio SMTP, ad esempio EmailException: Sending the email to the following server failed.
I registri di pubblicazione mostrano MailConnectException: Could not connect to the host, port.
L’e-mail funziona su localhost ma non riesce su AEM as a Cloud Service (dev, stage o publish).
L’endpoint e-mail di AEM Forms elabora più lentamente del previsto o non all’intervallo previsto.

Causa principale

Gli errori SMTP in uscita si verificano a causa di uno o più dei seguenti fattori: regole di inoltro delle porte di rete avanzate mancanti (necessarie per tutte le connessioni SMTP esterne in AEMaaCS), valori del servizio di posta OSGi non configurati correttamente (ad esempio, utilizzando la porta SMTP diretta invece di portOrig mappato), credenziali errate o distribuzione di configurazione come codice mancante in AEMaaCS, oppure malinteso del comportamento dell’utilità di pianificazione e dell’intervallo negli endpoint e-mail di AEM Forms.

Passaggi per riprodurre l’errore

Determina se l’ambiente è AEM as a Cloud Service o AEM 6.5 on-premise, in quanto il percorso di configurazione è diverso.
Esaminare i log degli errori per EmailException o MailConnectException voci.
Controllare l’origine di configurazione del servizio di posta: il file com.day.cq.mailer.DefaultMailService.cfg.json (AEMaaCS) o il servizio di posta Day CQ nella console Web (AEM 6.5).
Per AEMaaCS, la conferma dell’inoltro della porta di rete avanzata mappa portOrig (ad esempio, 30465 o 30587) alla porta di destinazione (465 o 587).

Risoluzione resolution

Per risolvere il problema:

Identifica il tipo di ambiente (AEM as a Cloud Service o AEM 6.5 on-premise) perché la configurazione della posta differisce tra loro.
Esamina i registri degli errori. Per AEMaaCS, apri Cloud Manager > ambienti > registri; per AEM 6.5, controlla error.log. Cerca EmailException, MailConnectException e proxy.tunnel. Se non vengono visualizzati registri rilevanti, imposta smtp.debug=true nella configurazione OSGi.
Individuare la configurazione del servizio di posta. Per AEMaaCS, controlla com.day.cq.mailer.DefaultMailService.cfg.json nella configurazione come codice; per on-premise, apri la console Web in /system/console/configMgr e seleziona Day CQ Mail Service. Verificare che i valori host SMTP, porta, nome utente, password e SSL siano compilati. Se la configurazione non è presente in AEMaaCS, distribuiscila come codice.
Solo per AEM as a Cloud Service, convalida Advanced Networking. Confermare che l’inoltro porta mappa portOrig (ad esempio, 30465 o 30587) alla porta di destinazione (465 o 587). Nella configurazione OSGi, smtp.host utilizza la variabile host proxy (AEM_PROXY_HOST, impostazione predefinita proxy.tunnel) e smtp.port utilizza il valore portOrig. Se necessario, aggiorna la configurazione portForwards in Cloud Manager.
Solo per AEM as a Cloud Service, configura correttamente la porta SMTP e SSL. Per SMTP abilitato per SSL (porta di destinazione 465), impostare smtp.port sulla porta 30xxx mappata e smtp.ssl=true (ad esempio, portOrig 30465 mappato a smtp.port 30465 con smtp.ssl=true).
Solo per AEM as a Cloud Service, verifica le variabili di ambiente. Nella configurazione dell’ambiente > di Cloud Manager >, verificare che le variabili quali EMAIL_USERNAME, EMAIL_PASSWORD e AEM_PROXY_HOST esistano e siano digitate correttamente, quindi ridistribuirle dopo eventuali modifiche. . Solo per AEM 6.5 on-premise, configura il servizio e-mail Day CQ. In /system/console/configMgr, selezionare Day CQ Mail Service e impostare l’host SMTP, una porta di 25 o superiore, l’utente e la password e un indirizzo di origine non vuoto. Riavvia AEM se le modifiche non hanno effetto.. Solo per AEM Forms, convalida l’endpoint e-mail. Esaminare l’intervallo di ripetizione, la dimensione del batch e l’espressione cron in modo che il modulo di pianificazione elabori i batch alla tempistica prevista e, se necessario, riconfigurare le impostazioni.. Verifica la consegna delle e-mail attivando la funzione che invia le e-mail (invio di un modulo, chiamata servlet o flusso di lavoro). Verificare che l’e-mail sia stata ricevuta e che i registri mostrino un handshake SMTP corretto senza EmailException o MailConnectException.. Se l’e-mail non riesce, contatta il Supporto Adobe con gli snippet di error.log che mostrano l’eccezione, il file di configurazione del servizio di posta Day CQ (AEMaaCS cfg.json), i dettagli di mappatura host e porta SMTP e la conferma dell’abilitazione della rete avanzata.

*### Lettura correlata AEM as a Cloud Service - Invio e-mail

recommendation-more-help

experience-cloud-kcs-help-kbarticles