DokumentationExperience Cloud KCS

AEM kann aufgrund einer fehlerhaften Konfiguration des E-Mail-Dienstes oder des erweiterten Netzwerks keine ausgehenden SMTP-E-Mails senden

Letzte Aktualisierung: 2. Juli 2026

AEM-Umgebungen können ausgehende E-Mails nicht senden, wobei in Protokollen SMTP-Verbindungsfehler wie EmailException oder MailConnectException und E-Mails angezeigt werden, die lokal funktionieren, aber auf AEM as a Cloud Service fehlschlagen. Um das Problem zu beheben, bestätigen Sie Ihren Umgebungstyp, korrigieren Sie den E-Mail-Service und die erweiterte Netzwerkkonfiguration und überprüfen Sie die SMTP-Konnektivität in den Protokollen.

Beschreibung description

Umgebung

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

Problem/Symptome

  • In den Protokollen wird ein SMTP-Sendefehler angezeigt, z. B. EmailException: Sending the email to the following server failed.
  • Veröffentlichungsprotokolle zeigen MailConnectException: Could not connect to the host, port an.
  • E-Mail funktioniert auf localhost, schlägt aber auf AEM as a Cloud Service fehl (dev, stage oder publish).
  • Der AEM Forms-E-Mail-Endpunkt verarbeitet langsamer als erwartet oder nicht im erwarteten Intervall.

Ursache

Ausgehende SMTP-Fehler treten aufgrund eines oder mehrerer der folgenden Probleme auf: fehlende Regeln für die Port-Weiterleitung für erweiterte Netzwerke (erforderlich für alle externen SMTP-Verbindungen in AEMaaCS), falsch konfigurierte Werte des OSGi-E-Mail-Service (z. B. Verwendung des direkten SMTP-Ports anstelle des zugeordneten portOrig), falsche Anmeldeinformationen oder eine fehlende Bereitstellung von Konfigurations-als-Code in AEMaaCS oder ein Missverständnis des Planungs- und Intervallverhaltens in E-Mail-Endpunkten von AEM Forms.

Schritte zur Reproduktion

  • Stellen Sie fest, ob es sich um eine On-Premise-Umgebung von AEM as a Cloud Service oder AEM 6.5 handelt, da der Konfigurationspfad unterschiedlich ist.
  • Überprüfen Sie die Fehlerprotokolle auf EmailException oder MailConnectException Einträge.
  • Überprüfen Sie die Konfigurationsquelle des E-Mail-Services: die com.day.cq.mailer.DefaultMailService.cfg.json-Datei (AEMaaCS) oder den Day CQ Mail Service in der Web-Konsole (AEM 6.5).
  • Bestätigen Sie für AEMaaCS, dass die Port-Weiterleitung für erweiterte Netzwerke Ihre portOrig (z. B. 30465 oder 30587) dem Ziel-Port (465 oder 587) zuordnet.

Lösung resolution

Beheben des Problems:

  1. Identifizieren Sie den Umgebungstyp - AEM as a Cloud Service oder AEM 6.5 On-Premise -, da die E-Mail-Konfiguration zwischen ihnen unterschiedlich ist.
  2. Überprüfen Sie die Fehlerprotokolle. Öffnen Sie für AEMaaCS Cloud Manager > Umgebungen > Protokolle; für AEM 6.5 error.log. Suchen Sie nach EmailException, MailConnectException und proxy.tunnel. Wenn keine relevanten Protokolle angezeigt werden, legen Sie in der OSGi-Konfiguration smtp.debug=true fest.
  3. Suchen Sie die E-Mail-Dienstkonfiguration. Überprüfen Sie für AEMaaCS die com.day.cq.mailer.DefaultMailService.cfg.json in Ihrer Konfiguration als Code; für On-Premise öffnen Sie die Web-Konsole unter /system/console/configMgr und wählen Sie Day CQ Mail Service. Bestätigen Sie, dass SMTP-Host, Port, Benutzername, Kennwort und SSL-Werte eingetragen sind. Wenn die Konfiguration in AEMaaCS fehlt, stellen Sie sie als Code bereit.
  4. Validieren Sie „Erweiterte Netzwerke“ nur für AEM as a Cloud Service. Bestätigen Sie, dass die Port-Weiterleitung Ihre portOrig (z. B. 30465 oder 30587) dem Ziel-Port (465 oder 587) zuordnet. In der OSGi-Konfiguration verwendet smtp.host die Proxy-Host-Variable (AEM_PROXY_HOST, proxy.tunnel) und smtp.port den portOrig. Aktualisieren Sie bei Bedarf die portForwards in Cloud Manager.
  5. Konfigurieren Sie nur für AEM as a Cloud Service den SMTP-Port und SSL richtig. Legen Sie für SSL-aktiviertes SMTP (Ziel-Port 465) smtp.port auf den zugeordneten 30xxx-Port und die smtp.ssl=true fest (z. B. portOrig 30465 ist smtp.port 30465 mit smtp.ssl=true zugeordnet).
  6. Überprüfen Sie Umgebungsvariablen nur für AEM as a Cloud Service. Bestätigen Sie in der Konfiguration der >-Umgebung von 0>, dass Variablen wie EMAIL_USERNAME, EMAIL_PASSWORD und AEM_PROXY_HOST vorhanden und korrekt geschrieben sind, und stellen Sie sie dann nach jeder Änderung erneut bereit. . Konfigurieren Sie den Day CQ-E-Mail-Service nur für On-Premise-Installationen von AEM 6.5. Wählen Sie /system/console/configMgr Day CQ Mail Service aus und legen Sie den SMTP-Host, einen Port von 25 oder höher, den Benutzer und das Kennwort sowie eine nicht leere Absenderadresse fest. Starten Sie AEM neu, wenn die Änderungen nicht übernommen werden.. Validieren Sie den E-Mail-Endpunkt nur für AEM Forms. Überprüfen Sie Wiederholungsintervall, Batch-Größe und Cron-Ausdruck, damit der Scheduler Batches zum erwarteten Zeitpunkt verarbeitet, und passen Sie die Einstellungen bei Bedarf an.. Testen Sie den E-Mail-Versand, indem Sie die Funktion auslösen, die die E-Mail sendet (Formularübermittlung, Servlet-Aufruf oder Workflow). Bestätigen Sie, dass die E-Mail empfangen wird und die Protokolle einen erfolgreichen SMTP-Handshake ohne EmailException oder MailConnectException anzeigen.. Wenn E-Mails weiterhin fehlschlagen, wenden Sie sich an den Adobe-Support. Dort finden Sie die error.log-Ausschnitte, die die Ausnahme anzeigen, Ihre Konfigurationsdatei für den Day CQ Mail Service (die AEMaaCS-cfg.json), Details zu Ihrem SMTP-Host und zur Port-Zuordnung sowie eine Bestätigung, ob das erweiterte Netzwerk aktiviert ist.

*### Verwandtes Lesen AEM as a Cloud Service - E-Mail wird gesendet

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