DocumentaciónKCS de Experience Cloud

AEM no puede enviar correos electrónicos SMTP salientes debido a una configuración incorrecta del servicio de correo o de la red avanzada

Última actualización: 2 de julio de 2026

Los entornos de AEM pueden no enviar correo electrónico saliente, con registros que muestren errores de conexión SMTP como EmailException o MailConnectException, y correo electrónico que funciona localmente pero falla en AEM as a Cloud Service. Para solucionar el problema, confirme el tipo de entorno, corrija el servicio de correo y la configuración de red avanzada, y valide la conectividad SMTP en los registros.

Descripción description

Entorno

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

Problema/Síntomas

  • Los registros muestran un error de envío SMTP como EmailException: Sending the email to the following server failed.
  • Los registros de publicación muestran MailConnectException: Could not connect to the host, port.
  • El correo electrónico funciona en localhost pero falla en AEM as a Cloud Service (desarrollo, fase o publicación).
  • El extremo del correo electrónico de AEM Forms se procesa más lentamente de lo esperado o no a los intervalos esperados.

Causa raíz

Los errores de SMTP salientes se producen debido a uno o más de los siguientes factores: falta de reglas de reenvío de puertos de red avanzadas (necesarias para todas las conexiones SMTP externas en AEMaaCS), valores de servicio de correo OSGi mal configurados (por ejemplo, el uso del puerto SMTP directo en lugar del portOrig asignado), credenciales incorrectas o una implementación de configuración como código faltante en AEMaaCS, o una mala comprensión del comportamiento del programador y el intervalo en los extremos de correo electrónico de AEM Forms.

Pasos a seguir

  • Determine si el entorno es AEM as a Cloud Service o AEM 6.5 local, ya que la ruta de configuración difiere.
  • Revise los registros de errores para EmailException o MailConnectException entradas.
  • Compruebe el origen de configuración del servicio de correo: el archivo com.day.cq.mailer.DefaultMailService.cfg.json (AEMaaCS) o el servicio Day CQ Mail en la consola web (AEM 6.5).
  • Para AEMaaCS, confirme que el reenvío de puertos de red avanzada asigna su portOrig (por ejemplo, 30465 o 30587) al puerto de destino (465 o 587).

Resolución resolution

Para solucionar el problema:

  1. Identifique el tipo de entorno (AEM as a Cloud Service o AEM 6.5 local) porque la configuración de correo difiere entre ellos.
  2. Revise los registros de errores. Para AEMaaCS, abra Cloud Manager > Entornos > Registros; para AEM 6.5, marque error.log. Busque EmailException, MailConnectException y proxy.tunnel. Si no aparecen registros relevantes, establezca smtp.debug=true en la configuración OSGi.
  3. Busque la configuración del servicio de correo. Para AEMaaCS, revise com.day.cq.mailer.DefaultMailService.cfg.json en su configuración como código; para obtener información local, abra la consola web en /system/console/configMgr y seleccione Servicio de correo CQ por día. Confirme que se han rellenado los valores de host SMTP, puerto, nombre de usuario, contraseña y SSL. Si falta la configuración en AEMaaCS, impleméntelo como código.
  4. Solo para AEM as a Cloud Service, valide Red avanzada. Confirme que el reenvío de puertos asigna su portOrig (por ejemplo, 30465 o 30587) al puerto de destino (465 o 587). En la configuración de OSGi, smtp.host usa la variable de host proxy (AEM_PROXY_HOST, predeterminado proxy.tunnel) y smtp.port usa el valor portOrig. Actualice la configuración de portForwards en Cloud Manager si es necesario.
  5. Solo para AEM as a Cloud Service, configure el puerto SMTP y SSL correctamente. Para SMTP habilitado para SSL (puerto de destino 465), establezca smtp.port en el puerto 30xxx asignado y smtp.ssl=true (por ejemplo, portOrig 30465 se asigna a smtp.port 30465 con smtp.ssl=true).
  6. Solo para AEM as a Cloud Service, compruebe las variables de entorno. En la configuración del entorno > de Cloud Manager >, confirme que las variables como EMAIL_USERNAME, EMAIL_PASSWORD y AEM_PROXY_HOST existen y están escritas correctamente y, a continuación, vuelva a implementarlas después de cualquier cambio. . Solo para AEM 6.5 local, configure el Day CQ Mail Service. En /system/console/configMgr, seleccione Servicio de correo CQ por día y establezca el host SMTP, un puerto de 25 o superior, el usuario y la contraseña, y una dirección remitente que no esté vacía. Reinicie AEM si los cambios no surten efecto.. Solo para AEM Forms, valide el punto final del correo electrónico. Revise el intervalo de repetición, el tamaño del lote y la expresión cron para que el programador procese los lotes en el tiempo esperado y vuelva a ajustar la configuración si es necesario.. Pruebe la entrega de correos electrónicos activando la función que envía correos electrónicos (envío de formulario, llamada al servlet o flujo de trabajo). Confirme que el correo electrónico se ha recibido y que los registros muestran un protocolo de enlace SMTP correcto sin EmailException ni MailConnectException.. Si el correo electrónico sigue fallando, póngase en contacto con el Soporte técnico de Adobe con los error.log fragmentos que muestran la excepción, el archivo de configuración del servicio de correo de CQ Day (AEMaaCS cfg.json), los detalles de asignación de puerto y host SMTP y la confirmación de si la red avanzada está habilitada.

*### Lectura relacionada AEM as a Cloud Service - Enviando correo electrónico

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