그누보드5 메일 테스트가 도착하지 않음

적용 범위

이 문서는 그누보드5 관리자에서 보낸 메일 테스트의 결과 메시지와 수신 여부를 확인하는 범위만 다룹니다. 회원 가입 인증 메일이 도착하지 않는 문제는 그누보드5 회원가입 인증 메일이 오지 않음에서 별도로 확인합니다.

SIR 매뉴얼에 따르면 기본메일환경에서 메일 발송 사용을 끄면 메일 발송과 메일 테스트를 사용할 수 없습니다. 메일 테스트는 결과 메시지가 표시된 뒤 지정한 주소에 실제 메일이 도착했는지 확인하는 기능입니다.

변경 없이 확인할 항목

1. 관리자 메일 테스트 화면의 결과 메시지와 테스트를 보낸 시각을 기록합니다.
2. 개인정보를 제외한 여러 테스트 수신 주소에서 메일 도착 여부를 각각 기록합니다.
3. 기본메일환경의 메일 발송 사용 설정 상태를 기록합니다.
4. 여러 주소에 보냈는데도 도착하지 않으면, 결과 메시지·발생 시각·수신 도메인만 정리해 웹 서버 관리자에게 전달합니다.

SIR 매뉴얼은 여러 주소에 보낸 테스트 메일도 도착하지 않으면 sendmail server 오류 가능성을 확인하고 웹 서버 관리자에게 문의하도록 안내합니다. 이 결과만으로 특정 서버 설정이나 수신 서비스가 원인이라고 확정하지는 않습니다.

다음 문서

회원 가입 인증 메일이 도착하지 않으면 그누보드5 회원가입 인증 메일이 오지 않음을 확인합니다. 운영자 알림과 회원 가입 인증 메일을 먼저 구분해야 하면 운영자·회원 가입 알림 메일이 오지 않아요를 확인합니다.

원인 분포

[Observation] 입력된 3건의 사례에서는 다음 원인이 관찰되었습니다.

• SMTP 연결 또는 인증 오류: 1건
• mailer() 호출의 함수 파라미터 문제와 SMTP 465 포트 설정 문제: 1건
• 외부 메일 인증·보안 연결·계정 설정 부족 및 기존 조건문 영향: 1건

[Observation] 위 분포는 수집된 사례에서 관찰된 유형의 건수이며, 실제 발생 빈도를 의미하지 않습니다.

오진 함정

[Observation] 관리자 메일 테스트가 성공해도 게시글 작성 후 mailer() 호출이 동작하지 않을 수 있습니다.

[Observation] 따라서 관리자 메일 테스트 성공만으로 게시글 작성 후 발송 경로까지 정상이라고 판단할 수 없습니다.

[Hypothesis] 테스트 경로와 게시글 작성 경로의 함수 호출 인자 또는 SMTP 설정이 다를 수 있으므로 두 경로를 분리해 확인해야 합니다.

환경 매트릭스

환경·조건	관찰된 증상	확인·수정 내용	결과
네이버 SMTP	관리자 메일 테스트 미도착, SMTP connect() failed 및 인증 오류	SMTP 디버그 출력과 보안 연결 설정 확인	테스트 메일 도착
AWS	관리자 메일 테스트 성공, 게시글 작성 후 mailer() 미동작	함수 파라미터 수정, SMTP 465 포트 사용	발송 성공
그누보드5.4·외부 메일 인증 설정 미비 환경	메일 수신 문제	SMTP 인증·보안 연결·계정 설정 추가 방법 적용, 기존 조건문 제거	네이버 메일 수신 정상화
호스팅 서버별 환경	결과가 서로 다름	사례에서 구체적인 공통 조치는 확인되지 않음	환경별 차이 기록

진단 순서

1. [Observation] 관리자 메일 테스트가 도착하지 않으면 SMTP 디버그 출력에서 연결 실패와 인증 오류를 확인합니다.
2. [Observation] SMTP 계정 설정과 보안 연결 설정을 확인합니다.
3. [Observation] 관리자 테스트는 성공하지만 게시글 작성 후 발송이 실패하면 mailer() 호출부의 함수 파라미터를 별도로 확인합니다.
4. [Observation] AWS 사례에서는 SMTP 465 포트 사용 후 발송이 성공했습니다.
5. [Observation] 외부 메일 인증 설정이 필요한 환경에서는 SMTP 인증·보안 연결·계정 설정을 확인합니다.
6. [Observation] 네이버 메일 사례에서는 기존 조건문 제거 후 수신이 정상화되었으므로 관련 조건문도 확인합니다.
7. [Observation] 호스팅 서버마다 결과가 달라질 수 있다는 기록이 있으므로 서버 환경별 결과를 따로 기록합니다.