DocumentaçãoKCS da Experience Cloud

AEM as a Cloud Service: falha na entrega de email SMTP

Última atualização: 17 de julho de 2026

A entrega de email SMTP pode falhar no Adobe Experience Manager as a Cloud Service (AEMaaCS) quando o serviço de email está configurado para se conectar diretamente a um host SMTP externo em uma porta não padrão ou quando a configuração de encaminhamento de porta do Advanced Networking necessária está ausente ou está incorreta. Resolva o problema configurando a Rede Avançada para o destino SMTP e atualizando o Day CQ Mail Service para usar o host do proxy e a porta do proxy mapeada.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (todas as versões)

Problema/Sintomas

Ao tentar enviar emails por SMTP, como por meio de trabalhos de implantação ou tarefas assíncronas, o delivery de email falha. Os seguintes erros são observados nos logs:

Caused by: org.apache.commons.mail.EmailException: Sending the email to the following server failed : your-smtp-host:465
    at org.apache.commons.mail.Email.sendMimeMessage(Email.java:1298) [ org.apache.commons.commons-email:1.6.0]
    ...
Caused by: com.sun.mail.util.MailConnectException: Couldn't connect to host, port: your-smtp-host, 465; timeout 60000
    at com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:2209) [ com.sun.mail.javax.mail:1.6.2]
    ...
Caused by: java.net.SocketTimeoutException: Connect timed out
    at java.base/sun.nio.ch.NioSocketImpl.timedFinishConnect(NioSocketImpl.java:546)
  • Falha no envio de email para trabalhos ou processos que usam SMTP.
  • Os logs mostram tempos limite de conexão quando o serviço de email tenta se conectar ao servidor SMTP na porta 465.
  • A configuração do Day CQ Mail Service deve ser revisada para confirmar se o AEM as a Cloud Service está usando o host de proxy necessário e a porta de proxy mapeada em vez de se conectar diretamente ao host e à porta SMTP externa.

Causa raiz

No AEM as a Cloud Service, o delivery SMTP pode falhar quando uma porta SMTP não padrão, como 465, é usada sem a configuração necessária de encaminhamento de porta de rede avançada ou quando o serviço de email é configurado para usar o host SMTP externo e a porta de destino diretamente em vez do host e da porta proxy mapeados.

Resolução resolution

Tente as seguintes etapas para resolver o problema:

  1. Certifique-se de que a Rede avançada esteja habilitada para o programa e o ambiente de destino do AEM as a Cloud Service e que você tenha as permissões necessárias para atualizar a rede e a configuração.

  2. No Cloud Manager, abra o programa e o ambiente relevantes. Vá para Rede Avançada e configure uma regra de saída de porta flexível para o seu serviço SMTP. Use uma regra semelhante ao exemplo a seguir, substituindo o nome do host e as portas pelos valores exigidos pelo provedor SMTP. Use um valor portOrig adequado no intervalo documentado para seu ambiente. Salve e aplique a configuração ao ambiente.

    code language-json 
    {
  "nonProxyHosts": [ ] ,
  "portForwards": [
    {
      "name": "smtp.example.com",
      "portDest": 465,
      "portOrig": 30465
    }
  ]
}

  3. Configure o serviço de email para usar o host de proxy e a porta de proxy mapeada, em vez de se conectar diretamente ao host e à porta SMTP externa. Use os seguintes valores:

    • smtp.host: $[ env:AEM_PROXY_HOST;default=proxy.tunnel]
    • smtp.port: <mapped-port> (ou o valor portOrig configurado acima)
    • smtp.user: um valor com suporte secreto para seu nome de usuário SMTP
    • smtp.password: um valor com suporte secreto para sua senha SMTP
    • from.address: um endereço de remetente válido, por exemplo no-reply@example.com
    • smtp.ssl: true quando o serviço SMTP de destino usa a porta 465

  4. Forneça o nome de usuário e a senha de SMTP usando a configuração com suporte secreta para o AEM as a Cloud Service em vez de armazenar valores de credencial literal no código.

  5. Implante a configuração atualizada por meio do processo padrão de implantação do Cloud Manager e, em seguida, teste o delivery de email executando novamente um processo que envia email e confirmando se a conexão foi bem-sucedida.

Leitura relacionada

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