DocumentationExperience Cloud KCS

AEM ne peut pas envoyer d’e-mails SMTP sortants en raison d’une mauvaise configuration du service de messagerie ou de la mise en réseau avancée

Dernière mise à jour : 2 juillet 2026

Les environnements AEM peuvent ne pas envoyer d’e-mails sortants, avec des journaux affichant les erreurs de connexion SMTP telles que EmailException ou MailConnectException, et des e-mails qui fonctionnent localement, mais échouent sur AEM as a Cloud Service. Pour résoudre ce problème, confirmez votre type d’environnement, corrigez la configuration du service de messagerie et de la Mise en réseau avancée, puis validez la connectivité SMTP dans les journaux.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • Adobe Experience Manager 6.5 (on-premise)
  • AEM Forms

Problème/Symptômes

  • Les journaux affichent un échec d’envoi SMTP tel que EmailException: Sending the email to the following server failed.
  • Les journaux de publication affichent MailConnectException: Could not connect to the host, port.
  • L’e-mail fonctionne sur localhost, mais échoue sur AEM as a Cloud Service (développement, évaluation ou publication).
  • Le point d’entrée de courrier électronique d’AEM Forms traite plus lentement que prévu ou à un intervalle imprévu.

Cause principale

Les échecs SMTP sortants se produisent en raison d’une ou de plusieurs des raisons suivantes : règles de transfert de port de réseau avancé manquantes (requises pour toutes les connexions SMTP externes dans AEMaaCS), valeurs de service de messagerie OSGi mal configurées (par exemple, en utilisant le port SMTP direct au lieu du portOrig mappé), informations d’identification incorrectes ou déploiement configuration en tant que code manquant dans AEMaaCS, ou une mauvaise compréhension du comportement du planificateur et de l’intervalle dans les points d’entrée de messagerie AEM Forms.

Procédure à suivre

  • Déterminez si l’environnement est AEM as a Cloud Service ou AEM 6.5 on-premise, car le chemin de configuration diffère.
  • Consultez les journaux d’erreurs pour les entrées EmailException ou MailConnectException.
  • Vérifiez la source de configuration du service de messagerie : le fichier com.day.cq.mailer.DefaultMailService.cfg.json (AEMaaCS) ou le Service de messagerie Day CQ dans la console web (AEM 6.5).
  • Pour AEMaaCS, confirmez que le transfert de port de réseau avancé mappe votre portOrig (par exemple, 30465 ou 30587) au port de destination (465 ou 587).

Résolution resolution

Pour résoudre le problème :

  1. Identifiez le type d’environnement (AEM as a Cloud Service ou AEM 6.5 On-premise), car la configuration du courrier électronique diffère entre eux.
  2. Consultez les journaux d’erreurs. Pour AEMaaCS, ouvrez Cloud Manager > Environnements > Journaux ; pour AEM 6.5, cochez error.log. Recherchez EmailException, MailConnectException et proxy.tunnel. Si aucun journal approprié n’apparaît, définissez smtp.debug=true dans la configuration OSGi.
  3. Recherchez la configuration du service de messagerie. Pour AEMaaCS, consultez les com.day.cq.mailer.DefaultMailService.cfg.json dans votre configuration en tant que code ; pour on-premise, ouvrez la console web à l’adresse /system/console/configMgr et sélectionnez Service de messagerie Day CQ. Vérifiez que l’hôte SMTP, le port, le nom d’utilisateur, le mot de passe et le SSL sont renseignés. Si la configuration est manquante dans AEMaaCS, déployez-la sous forme de code.
  4. Pour AEM as a Cloud Service uniquement, validez Mise en réseau avancée. Vérifiez que le transfert de port mappe votre portOrig (par exemple, 30465 ou 30587) au port de destination (465 ou 587). Dans la configuration OSGi, smtp.host utilise la variable hôte proxy (AEM_PROXY_HOST, proxy.tunnel par défaut) et smtp.port utilise la valeur portOrig. Mettez à jour la configuration portForwards dans Cloud Manager si nécessaire.
  5. Pour AEM as a Cloud Service uniquement, configurez correctement le port SMTP et le protocole SSL. Pour le protocole SMTP compatible SSL (port de destination 465), définissez smtp.port sur le port et le smtp.ssl=true 30xxx mappés (par exemple, portOrig 30465 mappe sur smtp.port 30465 avec smtp.ssl=true).
  6. Pour AEM as a Cloud Service uniquement, vérifiez les variables d’environnement. Dans la configuration du > de l’environnement > de Cloud Manager , vérifiez que les variables telles que EMAIL_USERNAME, EMAIL_PASSWORD et AEM_PROXY_HOST existent et sont orthographiées correctement, puis redéployez-les après toute modification.
  7. Pour AEM 6.5 On-premise uniquement, configurez le service de messagerie Day CQ. Dans /system/console/configMgr, sélectionnez Service de messagerie Day CQ et définissez l’hôte SMTP, un port égal ou supérieur à 25, l’utilisateur et le mot de passe, ainsi qu’une adresse d’expédition non vide. Redémarrez AEM si les modifications ne sont pas prises en compte.
  8. Pour AEM Forms uniquement, validez le point d’entrée de courrier électronique. Passez en revue l’intervalle de répétition, la taille du lot et l’expression cron afin que le planificateur traite les lots au moment prévu et ajuste à nouveau les paramètres si nécessaire.
  9. Testez la diffusion par e-mail en déclenchant la fonctionnalité qui envoie l’e-mail (envoi de formulaire, appel de servlet ou workflow). Vérifiez que l’e-mail est reçu et que les journaux affichent une authentification SMTP réussie sans EmailException ni MailConnectException.
  10. Si l’e-mail échoue toujours, contactez l’assistance 🔗 avec les fragments de code error.log indiquant l’exception, votre fichier de configuration du service de messagerie Day CQ (le cfg.json AEMaaCS), les détails de mappage de l’hôte et du port SMTP, et une confirmation indiquant si la mise en réseau avancée est activée.

Lecture connexe

recommendation-more-help
experience-cloud-kcs-help-kbarticles