📌 Gmail SMTP 메일 발송 (Spring Boot 기반) — 앱 비밀번호 사용

📅 2025-05-14

📝 학습 내용

1️⃣ Gmail 메일 전송 방식 개요

✅ Gmail API vs Gmail SMTP 차이점

항목	Gmail API	Gmail SMTP
인증 방식	OAuth 2.0 (access token)	앱 비밀번호
사용 방법	Google Cloud Console 설정 + OAuth 인증 흐름 필요	앱 비밀번호 발급만으로 사용 가능
주요 사용 목적	Gmail 콘텐츠 접근, 메일 관리	단순 메일 전송(SMTP 전송 전용)

이 글에서는 Gmail API(OAuth) 방식이 아닌, SMTP 방식으로 Gmail을 연동하여 메일을 전송하는 방법을 설명합니다.

---

2️⃣ Gmail 앱 비밀번호 설정 방법

• 경로: 구글 계정 > 보안 > 앱 비밀번호
• 설정 방법:
  • 앱 이름 예: "Mail API 테스트"
  • 생성된 16자리 앱 비밀번호는 반드시 복사/저장 (한 번만 표시됨)
  • 이 비밀번호는 실제 로그인 비밀번호가 아님
  • 2단계 인증이 활성화된 계정만 앱 비밀번호 생성 가능

---

3️⃣ Gradle 의존성 추가

// 메일 전송 기능을 위한 스타터
implementation 'org.springframework.boot:spring-boot-starter-mail'

---

4️⃣ application.properties 설정

## Google SMTP
spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.username=boogiewoong2@gmail.com
spring.mail.password=**** **** **** ****  # 앱 비밀번호 입력
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.debug=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.mime.charset=UTF-8
spring.mail.properties.mail.transport.protocol=smtp

🔒 보안 팁

• 실제 프로젝트에서는 위 설정을 application.yml 또는 .env 파일로 외부 분리
• 민감 정보는 절대 Git에 올라가지 않도록 .gitignore 설정 필요!

---

5️⃣ 메일 발송 컨트롤러 구현

package com.example.demo.C06Google;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@Slf4j
@RequestMapping("/google/mail")
public class C01GoogleMailAPIController {

    @Autowired
    JavaMailSender javaMailSender;

    @GetMapping("/req")
    @ResponseBody
    public String req(@RequestParam("email") String email, @RequestParam("text") String text){
        log.info("GET /google/mail/req 요청 수신...");

        try {
            // 단순 텍스트 메일 구성
            SimpleMailMessage message = new SimpleMailMessage();
            message.setTo(email); // 수신자 주소
            message.setSubject("[WEB발신] 메일 테스트입니다"); // 메일 제목
            message.setText(text); // 본문 내용

            javaMailSender.send(message); // 전송
            return "✅ 메일 전송 성공!";
        } catch (Exception e) {
            log.error("메일 전송 실패", e);
            return "❌ 메일 전송 실패: " + e.getMessage();
        }
    }
}

---

🔥 정리

• spring-boot-starter-mail과 JavaMailSender를 사용해 Gmail을 통한 SMTP 메일 전송 구현 가능
• Gmail 계정은 2단계 인증 + 앱 비밀번호 설정이 필수
• 실무에선 HTML 메일, 파일 첨부, 템플릿 기반 메일 전송 등으로 확장 가능

---

🔗 참고 자료

• Spring Boot Mail 공식 문서
• Google 앱 비밀번호 공식 가이드
• Gmail SMTP 서버 문서

---

📢 다음 편에서는 HTML 메일 전송 / 첨부파일 추가 / MimeMessage 사용 예제를 다룰 예정이야!

필요하면 지금 바로 준비해줄게 😄

이제 이 내용을 벨로그에 바로 올릴 수 있어! 🚀

썸네일 이미지도 만들어줄까?