DocumentaçãoKCS da Experience Cloud

O AEM não pode enviar emails SMTP de saída devido ao serviço de email ou à configuração incorreta da rede avançada

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

Os ambientes do AEM podem deixar de enviar emails de saída, com logs mostrando erros de conexão SMTP, como EmailException ou MailConnectException, e emails que funcionam localmente, mas falham no AEM as a Cloud Service. Para corrigir o problema, confirme o tipo de ambiente, corrija o serviço de email e a configuração de rede avançada e valide a conectividade SMTP nos logs.

Descrição description

Ambiente

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

Problema/Sintomas

  • Os logs mostram uma falha de envio SMTP como EmailException: Sending the email to the following server failed.
  • Os logs de publicação mostram MailConnectException: Could not connect to the host, port.
  • O email funciona no host local, mas falha no AEM as a Cloud Service (desenvolvimento, preparação ou publicação).
  • O endpoint de email do AEM Forms é processado mais lentamente do que o esperado ou não no intervalo esperado.

Causa raiz

Falhas de SMTP de saída ocorrem devido a um ou mais dos seguintes motivos: ausência de regras de encaminhamento de porta do Advanced Networking (necessárias para todas as conexões SMTP externas no AEMaaCS), valores de serviço de email OSGi configurados incorretamente (por exemplo, usando a porta SMTP direta em vez da portOrig mapeada), credenciais incorretas ou uma implantação ausente de configuração como código no AEMaaCS ou um mal-entendido do comportamento do agendador e do intervalo nos pontos de extremidade de email do AEM Forms.

Etapas a serem reproduzidas

  • Determine se o ambiente é AEM as a Cloud Service ou AEM 6.5 no local, já que o caminho de configuração é diferente.
  • Examine os logs de erros de EmailException ou MailConnectException entradas.
  • Verifique a origem da configuração do serviço de email: o arquivo com.day.cq.mailer.DefaultMailService.cfg.json (AEMaaCS) ou o Serviço de Email do Day CQ no Console da Web (AEM 6.5).
  • Para o AEMaaCS, confirme se o encaminhamento de porta de rede avançada mapeia o portOrig (por exemplo, 30465 ou 30587) para a porta de destino (465 ou 587).

Resolução resolution

Para corrigir o problema:

  1. Identifique o tipo de ambiente (AEM as a Cloud Service ou AEM 6.5 no local) porque a configuração de email é diferente entre eles.
  2. Revise os logs de erro. Para o AEMaaCS, abra Cloud Manager > Ambientes > Logs; para o AEM 6.5, marque error.log. Pesquisar por EmailException, MailConnectException e proxy.tunnel. Se nenhum log relevante for exibido, defina smtp.debug=true na configuração OSGi.
  3. Localize a configuração do serviço de e-mail. Para o AEMaaCS, revise com.day.cq.mailer.DefaultMailService.cfg.json em sua configuração como código; para no local, abra o Console da Web em /system/console/configMgr e selecione Day CQ Mail Service. Confirme se o host SMTP, a porta, o nome de usuário, a senha e os valores de SSL estão preenchidos. Se a configuração estiver ausente no AEMaaCS, implante-a como código.
  4. Somente para o AEM as a Cloud Service, validar a rede avançada. Confirme se o encaminhamento de porta mapeia o portOrig (por exemplo, 30465 ou 30587) para a porta de destino (465 ou 587). Na configuração OSGi, smtp.host usa a variável de host proxy (AEM_PROXY_HOST, padrão proxy.tunnel) e smtp.port usa o valor portOrig. Atualize a configuração portForwards no Cloud Manager, se necessário.
  5. Somente para o AEM as a Cloud Service, configure a porta SMTP e o SSL corretamente. Para SMTP habilitado para SSL (porta de destino 465), defina smtp.port para sua porta 30xxx mapeada e smtp.ssl=true (por exemplo, portOrig 30465 mapeia para smtp.port 30465 com smtp.ssl=true).
  6. Somente para o AEM as a Cloud Service, verifique as variáveis de ambiente. Na Configuração do Ambiente > do Cloud Manager >, confirme se variáveis como EMAIL_USERNAME, EMAIL_PASSWORD e AEM_PROXY_HOST existem e estão escritas corretamente e, em seguida, reimplante após qualquer alteração.
  7. Somente para o AEM 6.5 no local, configure o Day CQ Mail Service. Em /system/console/configMgr, selecione Day CQ Mail Service e defina o host SMTP, uma porta 25 ou superior, o usuário e a senha e um endereço do remetente que não esteja em branco. Reinicie o AEM se as alterações não entrarem em vigor.
  8. Somente para o AEM Forms, valide o endpoint do email. Revise o intervalo de repetição, o tamanho do lote e a expressão cron para que o scheduler processe lotes no tempo esperado e ajuste novamente as configurações, se necessário.
  9. Teste o delivery de email acionando o recurso que envia email (um envio de formulário, chamada de servlet ou fluxo de trabalho). Confirme se o email foi recebido e se os logs mostram um handshake SMTP bem-sucedido sem EmailException ou MailConnectException.
  10. Se o email ainda falhar, contate o Suporte da Adobe com os error.log trechos que mostram a exceção, o arquivo de configuração do Day CQ Mail Service (o AEMaaCS cfg.json), os detalhes de mapeamento da porta e do host SMTP e a confirmação de que a Rede Avançada está habilitada.

Leitura relacionada

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