[트러블 슈팅] jakarta.mail.internet.addressexception: local address contains control or whitespace

구글링 해도 나오지 않던 에러를 해결하는 과정을 소개하며, 왜 발생하고 어떻게 해결했는지 소개하는 글입니다.
SMTP 기능에 대해 설명하지 않습니다.

서론

에어비앤비에 회원가입할 때, 회원이 입력한 이메일이 정상 이메일인지 확인하고자 인증번호를 보내고자 했습니다.

그래서, 아래와 같은 코드로 네이버 서버에 메일을 보냈으나, `jakarta.mail.internet.addressexception: local address contains control or whitespace` 에러가 javaMailSender.send(message) 에서 발생하였습니다.

public void sendVerificationEmail(String memberEmail) {
        try {
            SimpleMailMessage message = new SimpleMailMessage();

            message.setFrom(env.getProperty("spring.mail.username"));
            message.setTo(memberEmail);
            message.setSubject("Airdnb 클론 프로젝트에서 보낸 인증번호 입니다");
            message.setText(createRandomUUID());

     >>>>   javaMailSender.send(message);  <<<< 에러 발생 위치
        } catch (MailException e) {
        }
    }

 

해결과정 소개

1.에러를 직역하고, 구글링을 통해 풀고자 했습니다.

 

에러를 직역하자면, 내 로컬 네트워크 주소에 control 이나 공백이 포함되어 있다는데 와닿지 않아서  구글링을 해보았습니다. 구글링을 했으나 왜 이런 오류가 발생했고, 어떻게 해결했는지 나와있는 글을 찾지 못해서 StackTrace 를 거슬러 올라가고자 했습니다.

 

2. StackTrace 를 타고 심연으로 들어가기

StackTrace 중, InternetAddress.java:1352 에 보면, String 을 for 문으로 돌면서 char c 가 해당 if문에 참일 경우 해당 예외가 발생하는 것을 확인하였습니다.

- InternetAddress.java:1352

if (c <= 040 || c == 0177)
    throw new AddressException(
        "Local address contains control or whitespace", addr);

 

if 문의 의미를 해석해보겠습니다. 먼저, 040 와 0177 의 숫자 표기법은 8진법이니 10진법으로 바꾸겠습니다.

8진법 '040'은 10진법 '32'로 치환되며, 8진법 '0177'은 10진법 '127'로 치환됩니다. 그리고, 10진법은 ASCII 문자와 대응됩니다.

즉, char c 가 ASCII 문자로 32 보다 작거나 127 과 같다면 에러가 발생하게 됩니다.
ASCII 문자 에서 32보다 작고, 127인 문자를 공백문자 및 제어문자라 합니다.

그렇다면, 어떤 String 에서 공백문자와 제어문자가 있는지 확인하기 위해 String 을 어디서 받는지 StackTrace 를 다시 추적하였습니다.

 

그 결과로 JavaMailSenderImpl.java:314 에서 String 은 SimpleMailMessage 에서 나오는 것을 확인하였습다.

- JavaMailSenderImpl.java:314

@Override
    public void send(SimpleMailMessage... simpleMessages) throws MailException {
        List<MimeMessage> mimeMessages = new ArrayList<>(simpleMessages.length);
        for (SimpleMailMessage simpleMessage : simpleMessages) {
            MimeMailMessage message = new MimeMailMessage(createMimeMessage());
>>> 314라인 simpleMessage.copyTo(message);  <<<
            mimeMessages.add(message.getMimeMessage());
        }
        doSend(mimeMessages.toArray(new MimeMessage[0]), simpleMessages);
    }

 

디버깅으로 SimpleMailMessage 에 어떤 값들이 들어가는를 확인하였고, 클라이언트가 요청하는 데이터에 공백 문자인 '\r\n' 가 있는 것을 확인하였습니다.

 

즉, 컨트롤러에서 받은 요청 JSON이 파싱되지 않고, 문자 그대로인 String 으로 Service 까지 넘어간 것이 원인이었고, 컨트롤러에서는 { "email": "gromit1234@naver.com" } 인 JSON을 @RequestBody String email 으로 받고있었습니다.

단순하게 @RequestBody 사용하면, JSON이 파싱되어 원하는 값만 나올 것이라 생각하던 지식의 오류가 원인이었습니다...

 

이 지식의 오류를 김영한님의 스프링 메시지 컨버터 강의로 바로 잡았습니다😂
@ResponseBody 랑 @RequestBody 가 있을 시, 스프링 부트는 클래스 타입과 미디어 타입(헤더의 Content-Type || Accept)을 boolean 방식으로 체크해서 어떤 메시지 컨버터를 사용할 것인지 결정한다고 합니다.

0 = ByteArrayHttpMessageConvertor (바이트 처리)
1 = StringHttpMessageConvertor (문자 처리)
2 = MappingJackson2HttpMessageConvertor (객체/JSON 처리)
3= Jaxb2RootElementHttpMessageConverter (XML 처리)
...(중략)

 

문자를 처리하는 StringHttpMessageConvertor 의 클래스 타입은 String , 미디어 타입은 */* 이기 때문에 @RequestBody String email 의 경우, MappingJackson2HttpMessageConvertor 대신에 StringHttpMessageConvertor 가 선택되어 JSON 이 파싱되지 않는 것이었습니다.

 

그래서 EmailVertificationDto 클래스를 만들고, @RequestBody 의 클래스타입을 Object 로 만들어줌으로써 지식의 오류를 잡고 해결하게 되었습니다.

 

마치며

코드스쿼드를 다니며 Learning By Doing 방식으로 학습한 것들이 기억에 오래 남고, 이해가 훨신 잘되는 것을 몸소 체험해왔었는데, 이번 일을 계기로 확실히 인강을 그냥 듣는 것은 내게는 맞지 않는 방식임을 확인 할 수 있었습니다.

 

이로 인해, 앞으로도 무엇을 만들어가며 필요한 공부를 진행할 계획이며 Learning By Doing 로 학습해 나갈 것입니다.

코드스쿼드 만만세🙌(?)

 

 

• SimpleMailMessage 에 대해 알고 싶다면 ?  Spring Mail Guide 의 3.Mail Server Properties 보기
• 다양한 메시지 컨버터를 알고 싶다면 ? https://www.baeldung.com/spring-httpmessageconverter-rest 의 2.2 The Default Message Converters 보기