📒솜이노트 :: # JAVA - 메일로 임시 비밀번호 발급하는 방법 (Gmail SMTP)

메일로 임시 비밀번호를 발급하려면 일단 SMTP를 사용해야합니다.

저는 구글로 해당 기능을 사용해 보도록 하겠습니다.

Gmail SMTP

Gmail SMTP를 사용하려면 아래 3가지를 충족해야 합니다.

구글 계정이 2단계 인증(OTP) 활성화되어 있을 것
앱 비밀번호(App Password)를 발급받을 것
Spring Boot 메일 설정(application.properties)이 SMTP 규칙에 맞을 것

필요한 사전 조건

1) 구글 계정에서 2단계 인증 활성화

링크: https://support.google.com/accounts/answer/185839?hl=ko&co=GENIE.Platform%3DAndroid
→ “2단계 인증” 켜기

2단계 인증 사용 - Android - Google 계정 고객센터

2단계 인증을 사용하면 비밀번호가 도용되는 경우에 대비하여 계정 보안을 한층 강화할 수 있습니다. 2단계 인증을 설정한 후에는 다음을 사용하여 계정에 로그인할 수 있습니다. 비밀번호 및 2

support.google.com

2) App Password 발급

2단계 인증을 켠 뒤에 아래 메뉴가 보인다.

앱: Mail
기기: 원하는 이름(예: SpringBootServer)

→ 16자리 비밀번호가 생성됨
→ 이 코드가 SMTP 비밀번호 역할을 한다.

전체 구성

(1) application.properties 설정

spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.username=your_email@gmail.com
spring.mail.password=발급받은_앱_비밀번호
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.ssl.trust=smtp.gmail.com

(2) 의존성 추가 (build.gradle)

implementation 'org.springframework.boot:spring-boot-starter-mail'

(3) 템플릿 메일 발송 임시 코드

JavaMailSender + MimeMessageHelper를 이용해 HTML 형식으로 전달해야 한다.
변수를 템플릿에 바인딩하는 로직이 있어야 한다.

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<body style="font-family: Arial;">

    <h2 th:text="${title}">메일 제목</h2>

    <p th:text="${message}">기본 메시지</p>

    <div style="margin-top:20px; padding:10px; border:1px solid #ddd;">
        <p>보낸 시각: <span th:text="${sendTime}"></span></p>
    </div>

</body>
</html>

public class MailDTO {
    private String to;
    private String subject;
    private String title;
    private String message;
}

@Service
@RequiredArgsConstructor
public class MailService {

    private final JavaMailSender mailSender;
    private final SpringTemplateEngine templateEngine;

    public void sendTemplateMail(MailDTO dto) throws MessagingException {

        // MIME 메일 객체 생성
        MimeMessage mimeMessage = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true, "UTF-8");

        // 제목 / 받는사람 설정
        helper.setTo(dto.getTo());
        helper.setSubject(dto.getSubject());

        // 템플릿에 넣을 데이터 구성
        Context context = new Context();
        context.setVariable("title", dto.getTitle());
        context.setVariable("message", dto.getMessage());
        context.setVariable("sendTime", LocalDateTime.now().toString());

        // HTML 템플릿 렌더링
        String html = templateEngine.process("mail/sample-mail", context);

        // HTML 메일로 설정
        helper.setText(html, true);

        mailSender.send(mimeMessage);
    }
}

templateEngine.process("mail/sample-mail", context);
→ templates/mail/sample-mail.html 파일을 읽어서 HTML을 만들어줌
helper.setText(html, true)
→ true = HTML이라는 의미
메일 내용에 variables(title, message, sendTime)을 모두 바인딩할 수 있음.

@RestController
@RequiredArgsConstructor
@RequestMapping("/api/mail")
public class MailController {

    private final MailService mailService;

    @PostMapping("/send-template")
    public String sendTemplate(@RequestBody MailDTO dto) throws MessagingException {
        mailService.sendTemplateMail(dto);
        return "success";
    }
}

전송 테스트 (POST)

POST /api/mail/send-template
{
  "to": "받을사람@gmail.com",
  "subject": "템플릿 메일 테스트",
  "title": "환영합니다!",
  "message": "템플릿 기반 HTML 메일이 정상적으로 발송되었습니다."
}

이번 글은 기본 설정과 템플릿 기반 메일 발송까지 정리한 내용이다.

더 확장하여 다양한 곳에서도 활용하면 좋을 것 같다.

'🗄️ 백엔드 > ☕JAVA' 카테고리의 다른 글

# FCM Token 기반 푸시 알림 구현 (Expo + Spring Boot For Android) (0)	2025.12.04
# JAVA - 숫자 천 단위 콤마, 소수점 자릿수 포맷 설정 방법 (DecimalFormat 활용) (1)	2025.08.13
# Spring boot 디자인 패턴 정리 - 프록시(Proxy) 패턴 (2)	2025.07.23
# Spring boot 디자인 패턴 정리 - 전략(Strategy) 패턴 (2)	2025.07.23
# Spring boot 디자인 패턴 정리 - 싱글톤(Singleton) 패턴 (1)	2025.07.23

일	월	화	수	목	금	토
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31