--- title: "MAIL 문제" slug: "sens-troubleshoot-mail" updated: 2026-10-15T09:28:13Z published: 2026-10-15T09:28:13Z canonical: "guide.ncloud-docs.com/sens-troubleshoot-mail" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # MAIL 문제 Classic/VPC 환경에서 이용 가능합니다. MAIL를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. ## Gmail 수신자에게 메일 발송 실패 Gmail 수신자에게 메일 발송 시 실패합니다. #### 원인 2024년 1월 31일 18시 이후부터 Gmail 정책이 변경되어 Gmail 수신 주소로 메일을 보낼 경우, 발송 도메인에 대한 SPF, DKIM, DMARC 인증이 모두 완료되어야 합니다. 세 가지 인증이 완료되지 않은 경우, 해당 발송 건에 대해 네이버 클라우드 플랫폼에서 자체적으로 발송 실패 처리합니다. - [Gmail 발신자 가이드라인 변경에 따른 Gmail로의 발송 정책 변경 공지](https://www.ncloud.com/support/notice/all/1667) 참조 #### 해결 방법 발송 도메인의 SPF, DKIM, DMARC 인증 및 SPF, DKIM를 사용 상태로 적용해 주십시오. 인증을 적용하는 방법은 [Domain Management > 도메인 등록](/docs/cloudoutboundmailer-use-domain#%EB%8F%84%EB%A9%94%EC%9D%B8%EB%93%B1%EB%A1%9D)을 참조해 주십시오. ## 메일 발송 로그 확인 불가 발송한 메일 로그가 남아 있지 않습니다. #### 원인 메일 발송 이력 저장 기간은 최대 2개월입니다. 메일을 발송한 지 2개월이 지난 경우, 로그를 확인할 수 없습니다. #### 해결 방법 발송 시점이 최근 2개월 이내인지 확인해 주십시오. 로그 저장 기간이 경과된 경우에는, 로그가 자동으로 삭제되어 복구할 수 없습니다. ## "NONEXISTENT_DOMAIN_ADDRESS" 발송 결과 코드 및 "Recipient domain does not exist" 발송 결과 메시지 메일 발송 시 발송 결과 코드가 "NONEXISTENT_DOMAIN_ADDRESS" 이며, 발송 결과 메시지가 "Recipient domain does not exist" 입니다. #### 원인 - 수신 도메인의 MX 레코드가 조회되지 않거나, 연결 가능한 메일 서버가 없습니다. - 수신 도메인의 MX 레코드는 존재하지만, 해당 서버와의 연결 테스트에 모두 실패했습니다. #### 해결 방법 수신 도메인의 DNS 설정 또는 수신 서버의 상태로 인해 발생하는 문제입니다. 네이버 클라우드 플랫폼에서는 정확한 원인을 파악하기 어렵기 때문에 자세한 내용은 수신 측에 확인해 주십시오. ## "Connection reset" 발송 결과 메시지 메일 발송 시 발송 결과 메시지가 "Connection reset" 입니다. #### 원인 수신 서비스에서 연결된 커넥션을 끊었을 경우 발생하는 문제입니다. #### 해결 방법 원인에서 설명한 바와 같이, 네이버 클라우드 플랫폼에서는 정확한 원인을 파악하기 어렵기 때문에 자세한 내용은 수신 측에 확인해 주십시오. ## 대량 메일 발송 실패 대량 메일 발송 시 많은 수의 발송 건이 실패합니다. #### 원인 수신 메일 서버의 연결 종료, 타임아웃, 연결 리셋 등으로 인해 실패할 수 있습니다. "Connection closed by remote host", "Read timed out" 등의 결과 메시지는 수신측 환경에 따라 발생하는 오류입니다. #### 해결 방법 - 개별 실패 건에 대한 확인이 필요한 경우, `mail id` 또는 `request id`를 [고객 지원](https://www.ncloud.com/support/question/service)으로 전달해 주십시오. - `Connection closed by remote host`, `Read timed out`, `Connection reset` 등과 같이 수신측 사유로 인해 실패한 경우, 네이버 클라우드 플랫폼에서는 정확한 원인을 파악하기 어렵기 때문에 자세한 내용은 수신 측에 확인해 주십시오. ## 발송 차단 목록 일괄 조회/해제 불가 Send block list에 등록된 주소를 한 번에 조회하거나 일괄 해제하고 싶습니다. #### 원인 개인정보 보호 및 서비스 안정성을 위해 send block list에 등록된 이메일 주소를 일괄 조회하거나 차단을 해제하는 기능은 제공되지 않습니다. #### 해결 방법 **Send block list** 메뉴에서 개별 이메일 주소를 직접 입력하여 차단 여부를 확인하고, 필요 시 직접 차단해 주십시오. 차단 해제는 콘솔에서만 수행할 수 있으며 API는 지원되지 않습니다. ## 발송 실패인데 수신 여부가 Y로 표시 메일 발송 결과는 실패인데 수신 여부는 Y로 표시됩니다. #### 원인 수신 서버가 메일을 수신했지만 응답을 반환하지 않으면 정상 수신 여부를 확인할 수 없으므로 발송 결과를 실패로 처리합니다. 단, 수신자가 메일 본문에 포함된 이미지(URL)를 호출한 경우에는 수신 여부가 Y로 표시됩니다. #### 해결 방법 원인에서 설명한 바와 같이 수신 여부 Y는 메일 열람 여부를 기준으로 하며, 발송 성공 여부와는 무관할 수 있습니다. 이는 수신측 응답 방식에 따라 발생하는 정상적인 동작입니다. ## 수신 여부가 반영되지 않음 메일을 수신했으나 수신 여부가 반영되지 않습니다. #### 원인 메일 수신 여부는 수신자가 메일을 열었을 때 본문 내 삽입된 이미지(URL)가 호출되는지를 기준으로 판단합니다. 수신 여부가 반영되지 않는 상황은 다음과 같습니다. - 수신 측 메일 서비스가 이미지 호출을 차단한 경우 - 수신자의 네트워크 환경 또는 보안 정책으로 인해 이미지 URL 요청이 차단된 경우 - 메일을 수신했지만 읽지 않은 경우 #### 해결 방법 수신자가 메일을 실제로 열어보고 이미지를 로드해야 수신 여부가 Y로 표시됩니다. 이는 수신자 환경(보안 정책, 메일 클라이언트 설정 등)에 따라 달라질 수 있습니다. ## API를 통한 메일 발송 실패 MAIL API를 통해 메일 발송을 시도했으나, "IP not allowed for authentication." 오류가 발생합니다. #### 원인 MAIL 서비스에서는 발송 요청 IP를 별도로 차단하지 않습니다. 그러나 서브 계정으로 요청하는 경우, 해당 서브 계정의 접근 가능 소스(IP 허용 목록)에 요청 IP가 등록되어 있지 않으면 인증 오류가 발생합니다. #### 해결 방법 서브 계정으로 API 호출 시 "IP not allowed for authentication." 응답을 받은 경우, 해당 서브 계정의 접근 가능 소스를 확인하고 해당 IP를 허용 목록에 추가해 주십시오. 서브 계정의 접근 권한에 대한 자세한 설명은 [서브 계정 생성 및 관리](/docs/subaccount-use)를 참조해 주십시오. ## 대량 메일 발송 시 수신 지연 메일을 대량으로 발송했으나 수신까지 시간이 오래 걸립니다. #### 원인 - 메일을 대량으로 발송한 경우, 시스템이 발송 속도를 조정하여 순차적으로 처리하므로 수신이 지연될 수 있습니다. - 수신측 메일 서버의 처리 속도, 또는 시간당 수신 제한 등으로 인해 추가 지연이 발생할 수 있습니다. - 수신 제한이 있는 경우 재시도 처리되며 이 경우 최대 1일까지 소요될 수 있습니다. #### 해결 방법 - 수신 지연은 시스템 정상 동작 범주 내 처리입니다. 수신 상태는 네이버 클라우드 플랫폼 콘솔의 **Simple & Easy Notification Service > MAIL > Mailing List** 메뉴에서 확인해 주십시오. - 지속적으로 수신 지연이 발생하는 경우, 발송량을 조정하거나 및 수신측 정책을 확인해 주십시오. ## 발송 실패 표시 메일 발송 결과가 '발송 실패'로 표시됩니다. #### 원인 메일 수신 서버로부터 오류 응답이 도착한 경우, 해당 내용을 기반으로 발송 실패로 처리됩니다. #### 해결 방법 발송 실패 사유를 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Application Services** > **Simple & Easy Notification Service** > **MAIL** > **Mailing List** 메뉴를 차례대로 클릭해 주십시오. 2. 목록에서 **수신자 수**를 클릭해 주십시오. 3. 수신자별 목록에서 실패 상태의 메일을 클릭해 주십시오. 4. 메일 상세보기 화면에서 **실패 사유**를 클릭해 주십시오. - 수신 서버의 응답을 그대로 출력한 메시지이므로 해석이 어려울 수 있습니다. 더 자세한 설명이 필요한 경우, 실패 메시지를 [고객 지원](https://www.ncloud.com/support/question/service)으로 전달하여 문의해 주십시오. ## DKIM 인증 문제 MAIL의 DKIM 인증 관련 문제를 진단하고 해결하는 방법을 안내합니다. ### DKIM 인증 실패 체크리스트 DKIM 인증 문제 발생 시 다음 항목들을 순서대로 확인해 주십시오. **1단계: 선행 조건 확인** - 도메인 인증이 완료되었는가? - SPF 레코드가 정상 조회되는가? **2단계: DKIM 레코드 등록 확인** - TXT 레코드가 올바른 호스트에 등록되었는가? (`{selector}._domainkey.{domain}`) - DKIM 서명값이 멀티라인 형태로 분할 등록되었는가? **3단계: Selector 확인** - 환경과 리전에 맞는 Selector를 사용하고 있는가? **4단계: 레코드 조회 확인** - nslookup으로 레코드가 정상 조회되는가? - 조회 결과가 멀티라인 형태인가? (별개 레코드가 아닌지) **5단계: 콘솔 설정 확인** - DKIM 인증이 완료되었는가? - **[사용]** 버튼을 클릭하여 활성화했는가? ### DKIM 인증 실패 - DKIM 인증이 되지 않습니다. - DKIM 인증 실패로 메일 발송이 실패합니다. #### 원인 - Selector가 잘못 설정되었습니다. - DKIM 서명 값이 올바르게 등록되지 않았습니다. - 도메인 또는 SPF 인증 레코드가 누락되었습니다. #### 해결 방법 다음 사항들을 순서대로 확인해 주십시오. **1. 도메인 및 SPF 인증 확인** DKIM 인증의 선행 조건으로 도메인 및 SPF 인증을 위한 레코드가 등록되어 있어야 합니다. [도메인 확인](/docs/cloudoutboundmailer-use-domain#%EB%8F%84%EB%A9%94%EC%9D%B8%ED%99%95%EC%9D%B8)을 참조하여, 도메인 인증 토큰 값 및 SPF 레코드가 조회되는지 먼저 확인해 주십시오. **2. TXT 레코드 등록 확인** 등록한 도메인의 `{selector}._domainkey` 호스트에 DKIM 서명 값을 TXT 레코드로 등록해야 합니다. 예: 도메인이 `example.com`이고 Selector가 `ncpcompubkr`인 경우 - 호스트: `ncpcompubkr._domainkey.example.com` 주의 - DKIM 서명 값은 392자입니다. - DNS TXT 레코드에는 255자까지 입력 가능하므로, 큰따옴표로 묶어 여러 구문으로 분할 등록해야 합니다. - Global DNS의 경우, TXT 레코드가 255자를 초과하면 자동으로 줄바꿈이 적용되므로 서명값을 그대로 등록할 수 있습니다. 자세한 내용은 Global DNS를 참조해 주십시오. - 이용 중인 DNS 서비스 업체에서 255자 이상의 TXT 레코드 등록 기능을 지원하지 않는다면 해당 업체에 지원을 요청해 주십시오. - MAIL 서비스는 높은 수준의 보안을 유지하기 위해 2,048bit의 DKIM 서명만을 지원하고 있습니다. DKIM 키는 2,048bit를 사용해 주십시오. **3. Selector 확인** 환경 및 리전에 따라 Selector가 달라집니다. Selector를 확인하는 방법은 [DKIM 인증](/docs/cloudoutboundmailer-use-domain#DKIM%EC%9D%B8%EC%A6%9D)을 참조해 주십시오. | 환경 | 리전 | Selector | | --- | --- | --- | | 민간 | 한국(KR) | `ncpcompubkr` | | 민간 | 일본(JP) | `ncpcompubjpn` | | 금융 | 한국(KR) | `ncpcomfin` | | 공공 | 한국(KR) | `ncpcomgov` | **4. 레코드 조회 확인** 다음 명령어를 입력하여 DKIM 서명 값이 올바르게 등록되었는지 확인해 주십시오. ``` # nslookup 사용 $ nslookup -q=txt ncpcompubkr._domainkey.example.com # 또는 dig 사용 $ dig txt ncpcompubkr._domainkey.example.com ``` **올바른 등록 (멀티라인 형태)** ``` ncpcompubkr._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." "..." ``` 결과가 두 개의 문자열 블록으로 이루어진 **단일 레코드**의 멀티라인 형태로 조회되어야 합니다. **잘못된 등록 (별개 레코드)** ``` ncpcompubkr._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." ncpcompubkr._domainkey.example.com text = "..." ``` 위와 같이 **별개의 레코드**로 분리되어 등록된 경우, DKIM 인증에 실패하거나 성공/실패가 반복될 수 있습니다. 멀티라인 형태로 재등록해야 합니다. TXT 레코드 분할 등록 방법은 사용 중인 도메인 서비스 업체에 문의해 주십시오. **5. DKIM 인증 설정 확인** 콘솔에서 DKIM 인증 여부 및 사용 여부를 확인해 주십시오. 인증을 완료한 후 **[사용]** 버튼을 클릭하여 사용 설정까지 완료해야 메일 발송 시 DKIM 인증이 정상적으로 이뤄집니다. 자세한 내용은 [DKIM 인증](/docs/cloudoutboundmailer-use-domain#DKIM%EC%9D%B8%EC%A6%9D)을 참조해 주십시오. 주의 - 인증 완료 후 **[사용]** 버튼을 클릭하여 활성화하였다면, **[사용 중지]** 버튼으로 변경되고, "사용 중" 문구가 표기됩니다. - 인증이 완료된 레코드를 수정하거나 삭제하면 이후 메일 발송 시 인증에 실패할 수 있습니다. 따라서 인증을 위해 등록한 레코드는 변경 없이 그대로 유지해 주십시오. ### DKIM 서명값은 조회되나 인증 실패 DKIM 서명값이 정상적으로 조회되나, DKIM 인증 시도 시 실패합니다. #### 원인 - 도메인 또는 SPF 인증을 위한 레코드가 잘못 등록되어 있거나 누락되었습니다. - DNS 레코드 변경 사항이 전파되는 중일 수 있습니다. #### 해결 방법 DKIM 인증을 정상적으로 수행하려면 도메인 및 SPF 인증을 위한 레코드가 모두 등록되어 있어야 합니다. [도메인 확인](/docs/cloudoutboundmailer-use-domain#%EB%8F%84%EB%A9%94%EC%9D%B8%ED%99%95%EC%9D%B8)을 참조하여, 도메인 인증 토큰 값 및 SPF 레코드가 조회되는지 확인해 주십시오. **DNS 레코드 전파 대기** 레코드를 올바르게 등록하였으나 인증에 실패하는 경우, DNS 레코드 변경 사항이 전파되기까지 시간이 소요될 수 있습니다. 일정 시간(보통 수 분에서 최대 24시간)이 경과한 후 다시 인증을 시도해 주십시오. 주의 - DNS 서버별 전파 시간 차이: 조회하는 DNS 서버에 따라 전파되는 시간이 다를 수 있습니다. 사용자가 직접 조회 시 올바른 레코드가 반환되더라도, 내부 인증 서버에는 아직 전파되지 않아 인증이 실패할 수 있습니다. - TTL(Time To Live) 캐시: 이전 레코드 등록 시 TTL을 길게 설정한 경우, 기존 레코드가 캐시되어 조회될 수 있습니다. 이 경우 TTL이 경과된 이후에 새 레코드가 정상 조회됩니다. - 레코드 갱신: 내부적으로 별도의 레코드 강제 갱신 작업은 지원하지 않습니다. 레코드 등록 시 적절한 TTL 값(예: 300초~3600초) 설정을 권장합니다. ### 메일 발송 시 성공/실패 반복 - DKIM 인증을 완료했습니다. - 메일 발송 시 발송 결과에 성공/실패가 반복됩니다. #### 원인 - DKIM 서명값이 별개의 레코드로 등록되어 있으면 성공과 실패를 반복할 수 있습니다. - DNS 레코드 조회 결과는 순서가 보장되지 않기 때문에 반환되는 순서에 따라 DKIM 인증 결과가 성공/실패로 달라질 수 있습니다. #### 해결 방법 [도메인 확인](/docs/cloudoutboundmailer-use-domain#%EB%8F%84%EB%A9%94%EC%9D%B8%ED%99%95%EC%9D%B8)을 참조하여 DKIM 서명값이 정상적으로 등록되었는지 확인해 주십시오. **레코드 조회 및 확인** ``` $ nslookup -q=txt ncpcompubkr._domainkey.example.com ``` **올바른 형태 (단일 레코드의 멀티라인)** ``` ncpcompubkr._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." "..." ``` **잘못된 형태 (별개의 레코드로 분리)** ``` ncpcompubkr._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." ncpcompubkr._domainkey.example.com text = "..." ``` 별개의 레코드로 등록된 경우, DNS 조회 시 순서가 보장되지 않아 성공/실패가 반복됩니다. 반드시 단일 레코드의 멀티라인 형태로 재등록해야 합니다. TXT 레코드 분할 등록 방법은 사용 중인 도메인 서비스 업체에 문의해 주십시오. ## SPF 인증 실패 SPF 인증이 정상적으로 이루어지지 않습니다. #### 원인 도메인의 TXT 레코드에 SPF 정보가 올바르게 등록되지 않았거나 형식에 문제가 있습니다. #### 해결 방법 등록한 도메인의 TXT 레코드를 점검하는 방법은 다음과 같습니다. 1. 도메인에 등록한 SPF 레코드를 조회하기 위해 다음 명령어를 입력해 주십시오. ``` nslookup -q=txt example.com ``` 2. 다음과 같이 하나의 문자열 블록으로 SPF 레코드가 조회되는지 확인해 주십시오. ``` example.com text = "v=spf1 include:email.ncloud.com ~all" ``` - 조회 결과에 큰따옴표로 감싸진 한 줄의 문자열로 SPF가 등록되어 있어야 합니다. 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.