설명서Experience Cloud KCS

메일 서비스 또는 고급 네트워킹 구성 오류로 인해 AEM에서 아웃바운드 SMTP 이메일을 보낼 수 없습니다

마지막 업데이트: 2026년 7월 2일

EmailException 또는 MailConnectException과(와) 같은 SMTP 연결 오류를 표시하는 로그와 로컬에서 작동하지만 AEM as a Cloud Service에서 실패하는 이메일을 사용하여 AEM 환경에서 아웃바운드 전자 메일을 보내지 못할 수 있습니다. 이 문제를 해결하려면 환경 유형을 확인하고 메일 서비스 및 고급 네트워킹 구성을 수정한 다음 로그에서 SMTP 연결을 확인합니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • Adobe Experience Manager 6.5 (온-프레미스)
  • AEM Forms

문제/증상

  • 로그에 EmailException: Sending the email to the following server failed과(와) 같은 SMTP 전송 실패가 표시됩니다.
  • 게시 로그에 MailConnectException: Could not connect to the host, port이(가) 표시됩니다.
  • 이메일은 localhost에서 작동하지만 AEM as a Cloud Service(개발, 스테이지 또는 게시)에서 실패합니다.
  • AEM Forms 이메일 엔드포인트 프로세스가 예상보다 느리거나 예상 간격에 해당하지 않습니다.

근본 원인

아웃바운드 SMTP 실패는 고급 네트워킹 포트 전달 규칙 누락(AEMaaCS의 모든 외부 SMTP 연결에 필요), 잘못 구성된 OSGi 메일 서비스 값(예: 매핑된 portOrig 대신 직접 SMTP 포트 사용), 잘못된 자격 증명 또는 AEMaaCS의 구성-코드 배포 누락, AEM Forms 이메일 엔드포인트의 스케줄러 및 간격 동작 오해 중 하나 이상으로 인해 발생합니다.

재현 단계

  • 구성 경로가 다르므로 환경이 AEM as a Cloud Service 또는 AEM 6.5 온프레미스인지 판단합니다.
  • EmailException 또는 MailConnectException 항목에 대한 오류 로그를 검토하십시오.
  • 메일 서비스 구성 원본: 웹 콘솔(AEM 6.5)에서 com.day.cq.mailer.DefaultMailService.cfg.json 파일(AEMaaCS) 또는 일 CQ 메일 서비스를 확인하십시오.
  • AEMaaCS의 경우 고급 네트워킹 포트 전달이 portOrig(예: 30465 또는 30587)을 대상 포트(465 또는 587)에 매핑하는지 확인하십시오.

해결 방법 resolution

문제를 해결하려면 다음을 수행하십시오.

  1. 메일 구성이 서로 다르므로 환경 유형(AEM as a Cloud Service 또는 AEM 6.5 온프레미스)을 식별합니다.
  2. 오류 로그를 검토하십시오. AEMaaCS의 경우 Cloud Manager > 환경 > 로그를 열고 AEM 6.5의 경우 error.log을(를) 확인합니다. EmailException, MailConnectException 및 proxy.tunnel을(를) 검색합니다. 관련 로그가 나타나지 않으면 OSGi 구성에서 smtp.debug=true을(를) 설정하십시오.
  3. 메일 서비스 구성을 찾습니다. AEMaaCS의 경우 com.day.cq.mailer.DefaultMailService.cfg.json을(를) 코드로 검토하세요. 온-프레미스의 경우 /system/console/configMgr에서 웹 콘솔을 열고 일 CQ 메일 서비스를 선택하세요. SMTP 호스트, 포트, 사용자 이름, 암호 및 SSL 값이 채워졌는지 확인합니다. AEMaaCS에서 구성이 누락된 경우 코드로 배포합니다.
  4. AEM as a Cloud Service의 경우에만 고급 네트워킹을 확인하십시오. 포트 전달이 portOrig(예: 30465 또는 30587)을 대상 포트(465 또는 587)에 매핑하는지 확인합니다. OSGi 구성에서 smtp.host은(는) 프록시 호스트 변수(AEM_PROXY_HOST, 기본값 proxy.tunnel)를 사용하고 smtp.port은(는) portOrig 값을 사용합니다. 필요한 경우 Cloud Manager에서 portForwards 구성을 업데이트합니다.
  5. AEM as a Cloud Service의 경우에만 SMTP 포트 및 SSL을 올바르게 구성합니다. SSL 사용 SMTP(대상 포트 465)의 경우 smtp.port을(를) 매핑된 30xxx 포트 및 smtp.ssl=true(예: portOrig이(가) smtp.ssl=true을(를) 30465 smtp.port에 매핑되도록 30465) 설정합니다.
  6. AEM as a Cloud Service의 경우에만 환경 변수를 확인하십시오. Cloud Manager > 환경 > 구성에서 EMAIL_USERNAME, EMAIL_PASSWORD 및 AEM_PROXY_HOST과(와) 같은 변수가 있고 철자가 올바른지 확인한 다음 변경 후 다시 배포합니다.
  7. AEM 6.5 온프레미스만의 경우 일별 CQ 메일 서비스를 구성합니다. /system/console/configMgr에서 일 CQ 메일 서비스를 선택하고 SMTP 호스트, 25 이상의 포트, 사용자 및 암호와 비어 있지 않은 보낸 사람 주소를 설정합니다. 변경 사항이 적용되지 않으면 AEM을 다시 시작합니다.
  8. AEM Forms의 경우에만 이메일 엔드포인트의 유효성을 검사합니다. 스케줄러가 예상 시간에 배치를 처리할 수 있도록 반복 간격, 배치 크기 및 cron 표현식 을 검토하고 필요한 경우 설정을 다시 조정합니다.
  9. 이메일을 보내는 기능(양식 제출, 서블릿 호출 또는 워크플로우)을 트리거하여 이메일 게재를 테스트합니다. 전자 메일이 수신되었고 로그에 EmailException 또는 MailConnectException 없이 성공적인 SMTP 핸드셰이크가 표시되는지 확인하십시오.
  10. 이메일이 계속 실패하면 예외, 일별 CQ 메일 서비스 구성 파일(AEMaaCS cfg.json), SMTP 호스트 및 포트 매핑 세부 정보 및 고급 네트워킹의 사용 여부를 확인하는 error.log 코드 조각을 사용하여 Adobe 지원에 문의하십시오.

관련 읽기

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