<!-- SpringBoot 郵件發(fā)送核心依賴，自動(dòng)引入 JavaMail 相關(guān)依賴 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>
<!-- 可選：lombok，簡化代碼，無需寫getter/setter、log日志等 -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional> <!-- 可選依賴，不影響其他模塊 -->
</dependency>
<!-- 可選：spring-boot-starter-web，用于提供測(cè)試接口，若項(xiàng)目已引入可忽略 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

spring:
  mail:
    # 發(fā)件人郵箱地址（QQ/163/企業(yè)郵箱均可，需與下方SMTP地址對(duì)應(yīng)）
    username: 123456@qq.com
    # 授權(quán)碼（不是郵箱登錄密碼！是上一步獲取的第三方應(yīng)用授權(quán)碼）
    password: abcdefghijklmnop
    # SMTP 服務(wù)器地址（對(duì)應(yīng)郵箱，不可寫錯(cuò)，QQ郵箱：smtp.qq.com；163郵箱：smtp.163.com）
    host: smtp.qq.com
    # 編碼格式，固定為 UTF-8，避免郵件標(biāo)題、內(nèi)容出現(xiàn)中文亂碼
    default-encoding: UTF-8
    # 額外配置：解決超時(shí)、加密、認(rèn)證等問題，生產(chǎn)環(huán)境必配
    properties:
      mail:
        smtp:
          # 必須開啟 SMTP 認(rèn)證（true），否則郵箱服務(wù)器會(huì)拒絕發(fā)送請(qǐng)求
          auth: true
          # 開啟 TLS 加密，提升郵件發(fā)送安全性，避免郵件被攔截
          starttls:
            enable: true
            required: true # 強(qiáng)制使用 TLS 加密
          # 郵件發(fā)送端口，推薦 587（TLS），465（SSL）也可，需與加密方式對(duì)應(yīng)
          port: 587
        # 超時(shí)設(shè)置（單位：毫秒），避免網(wǎng)絡(luò)波動(dòng)、服務(wù)器響應(yīng)慢導(dǎo)致發(fā)送超時(shí)
        timeout: 10000 # 郵件發(fā)送超時(shí)時(shí)間
        connectiontimeout: 10000 # 連接服務(wù)器超時(shí)時(shí)間
        writetimeout: 10000 # 寫入數(shù)據(jù)超時(shí)時(shí)間
# 日志配置（可選，用于排查郵件發(fā)送問題，開發(fā)環(huán)境建議開啟）
logging:
  level:
    # 開啟 Spring 郵件發(fā)送相關(guān)日志，DEBUG 級(jí)別可查看完整發(fā)送流程
    org.springframework.mail: DEBUG
    # 開啟自定義郵件相關(guān)日志（替換為自己的包名）
    com.example.mail: INFO

import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Component;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
/**
 * 郵件發(fā)送工具類（聚焦文本、HTML 兩種常用郵件，適配多場(chǎng)景復(fù)用）
 * 注：工具類使用 @Component 注解，交給 Spring 管理，可在 Service、Controller 中直接注入使用
 */
@Slf4j // lombok 注解，自動(dòng)生成 log 日志對(duì)象，無需手動(dòng)創(chuàng)建
@Component
@RequiredArgsConstructor // lombok 注解，自動(dòng)注入構(gòu)造方法，無需寫 @Autowired
public class MailUtil {
    // 核心發(fā)送接口，SpringBoot 自動(dòng)根據(jù)配置文件創(chuàng)建實(shí)例，直接注入即可
    private final JavaMailSender javaMailSender;
    // 從 application.yml 配置文件中讀取發(fā)件人郵箱，無需硬編碼
    @Value("${spring.mail.username}")
    private String defaultFromMail;
    // 1. 發(fā)送純文本郵件（重載方法，支持單收件人、多收件人，適配不同場(chǎng)景）
    /**
     * 單收件人文本郵件
     * @param to 收件人郵箱地址（單個(gè)）
     * @param subject 郵件主題
     * @param content 郵件純文本內(nèi)容
     */
    public void sendTextMail(String to, String subject, String content) {
        sendTextMail(new String[]{to}, subject, content);
    }
    /**
     * 多收件人文本郵件
     * @param to 收件人郵箱地址數(shù)組（多個(gè)）
     * @param subject 郵件主題
     * @param content 郵件純文本內(nèi)容
     */
    public void sendTextMail(String[] to, String subject, String content) {
        try {
            // 創(chuàng)建純文本郵件實(shí)例
            SimpleMailMessage message = new SimpleMailMessage();
            message.setFrom(defaultFromMail); // 設(shè)置發(fā)件人（從配置文件讀取，避免硬編碼）
            message.setTo(to); // 設(shè)置收件人（可單個(gè)、可多個(gè)）
            message.setSubject(subject); // 設(shè)置郵件主題
            message.setText(content); // 設(shè)置郵件純文本內(nèi)容
            javaMailSender.send(message); // 發(fā)送郵件
            log.info("純文本郵件發(fā)送成功，收件人：{}，郵件主題：{}", String.join(",", to), subject);
        } catch (Exception e) {
            // 捕獲所有異常，記錄日志，避免影響主流程
            log.error("純文本郵件發(fā)送失敗，收件人：{}，郵件主題：{}，異常信息：{}", 
                    String.join(",", to), subject, e.getMessage(), e);
            // 拋出運(yùn)行時(shí)異常，由調(diào)用方根據(jù)業(yè)務(wù)需求處理（如重試、返回錯(cuò)誤信息）
            throw new RuntimeException("文本郵件發(fā)送失敗，請(qǐng)稍后重試", e);
        }
    }
    // 2. 發(fā)送 HTML 富文本郵件（重載方法，支持單收件人、多收件人，帶樣式）
    /**
     * 單收件人 HTML 郵件
     * @param to 收件人郵箱地址（單個(gè)）
     * @param subject 郵件主題
     * @param htmlContent HTML 格式的郵件內(nèi)容（支持樣式、鏈接、圖片等）
     * @throws MessagingException 郵件發(fā)送相關(guān)異常（如配置錯(cuò)誤、網(wǎng)絡(luò)問題）
     */
    public void sendHtmlMail(String to, String subject, String htmlContent) throws MessagingException {
        sendHtmlMail(new String[]{to}, subject, htmlContent);
    }
    /**
     * 多收件人 HTML 郵件
     * @param to 收件人郵箱地址數(shù)組（多個(gè)）
     * @param subject 郵件主題
     * @param htmlContent HTML 格式的郵件內(nèi)容（支持樣式、鏈接、圖片等）
     * @throws MessagingException 郵件發(fā)送相關(guān)異常（如配置錯(cuò)誤、網(wǎng)絡(luò)問題）
     */
    public void sendHtmlMail(String[] to, String subject, String htmlContent) throws MessagingException {
        try {
            // 創(chuàng)建復(fù)雜郵件實(shí)例（支持 HTML、附件、內(nèi)嵌圖片等）
            MimeMessage message = javaMailSender.createMimeMessage();
            // 創(chuàng)建輔助類，第一個(gè)參數(shù)：郵件實(shí)例；第二個(gè)參數(shù)：true 表示支持多部分內(nèi)容（如 HTML）；第三個(gè)參數(shù)：編碼格式
            MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
            helper.setFrom(defaultFromMail); // 發(fā)件人
            helper.setTo(to); // 收件人（多收件人傳入數(shù)組）
            helper.setSubject(subject); // 郵件主題
            // 第二個(gè)參數(shù) true：開啟 HTML 解析，否則會(huì)將 HTML 標(biāo)簽顯示為純文本
            helper.setText(htmlContent, true);
            javaMailSender.send(message); // 發(fā)送郵件
            log.info("HTML 郵件發(fā)送成功，收件人：{}，郵件主題：{}", String.join(",", to), subject);
        } catch (MessagingException e) {
            log.error("HTML 郵件發(fā)送失敗，收件人：{}，郵件主題：{}，異常信息：{}", 
                    String.join(",", to), subject, e.getMessage(), e);
            // 拋出異常，由調(diào)用方處理（如返回錯(cuò)誤信息、重試）
            throw e;
        }
    }
}

import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.mail.MessagingException;
/**
 * 郵件發(fā)送測(cè)試接口（實(shí)際項(xiàng)目中可整合到 Service 層，結(jié)合業(yè)務(wù)場(chǎng)景調(diào)用）
 * 接口采用 GET 請(qǐng)求，方便快速測(cè)試；正式環(huán)境可根據(jù)需求改為 POST 請(qǐng)求
 */
@RestController
@RequestMapping("/mail") // 接口統(tǒng)一前綴，便于管理
@RequiredArgsConstructor
public class MailController {
    // 注入郵件工具類，直接調(diào)用發(fā)送方法
    private final MailUtil mailUtil;
    // 測(cè)試：發(fā)送純文本郵件（單收件人，GET請(qǐng)求，方便快速測(cè)試）
    @GetMapping("/send/text")
    public String sendTextMail(
            @RequestParam String to, // 收件人郵箱地址（必填）
            @RequestParam String subject, // 郵件主題（必填）
            @RequestParam String content // 郵件純文本內(nèi)容（必填）
    ) {
        mailUtil.sendTextMail(to, subject, content);
        return "純文本郵件發(fā)送成功！";
    }
    // 測(cè)試：發(fā)送 HTML 富文本郵件（單收件人，GET請(qǐng)求，方便快速測(cè)試）
    @GetMapping("/send/html")
    public String sendHtmlMail(
            @RequestParam String to, // 收件人郵箱地址（必填）
            @RequestParam String subject // 郵件主題（必填）
    ) throws MessagingException {
        // 構(gòu)建 HTML 內(nèi)容（支持樣式、鏈接、表格等，可根據(jù)實(shí)際業(yè)務(wù)需求修改）
        // 示例：模擬用戶注冊(cè)驗(yàn)證郵件，包含驗(yàn)證碼、鏈接等核心元素
        String htmlContent = "<!DOCTYPE html>" +
                "<html lang='zh-CN'>" +
                "<head><meta charset='UTF-8'><title>" + subject + "</title></head>" +
                "<body style='font-family: \"Microsoft YaHei\", sans-serif;'>" +
                "<div style='width: 600px; margin: 0 auto; padding: 20px; border: 1px solid #eee; border-radius: 5px;'>" +
                "<h2 style='color: #1E90FF; text-align: center; margin-bottom: 20px;'>用戶注冊(cè)驗(yàn)證</h2>" +
                "<p style='font-size: 14px; line-height: 1.5;'>尊敬的用戶，您好！</p>" +
                "<p style='font-size: 14px; line-height: 1.5;'>您正在進(jìn)行注冊(cè)驗(yàn)證，本次驗(yàn)證碼為：</p>" +
                "<div style='font-size: 24px; color: #FF4500; font-weight: bold; text-align: center; margin: 15px 0;'>123456</div>" +
                "<p style='font-size: 14px; line-height: 1.5;'>驗(yàn)證碼有效期為 5 分鐘，請(qǐng)?jiān)谟行趦?nèi)完成驗(yàn)證。</p>" +
                "<p style='font-size: 14px; line-height: 1.5;'>若您未發(fā)起注冊(cè)操作，請(qǐng)忽略此郵件，感謝您的支持！</p>" +
                "<p style='font-size: 12px; color: #999; margin-transform: translateY( 30px; text-align: center;'>此為系統(tǒng)自動(dòng)發(fā)送郵件，請(qǐng)勿回復(fù)</p>" +
                "</div>" +
                "</body></html>";
        mailUtil.sendHtmlMail(to, subject, htmlContent);
        return "HTML 郵件發(fā)送成功！";
    }
    // 測(cè)試：多收件人發(fā)送純文本郵件（實(shí)際場(chǎng)景常用，如批量通知）
    @GetMapping("/send/text/batch")
    public String sendBatchTextMail(
            @RequestParam String[] to, // 多收件人郵箱地址數(shù)組（必填，格式：xxx@qq.com,xxx@163.com）
            @RequestParam String subject, // 郵件主題（必填）
            @RequestParam String content // 郵件純文本內(nèi)容（必填）
    ) {
        mailUtil.sendTextMail(to, subject, content);
        return "多收件人文本郵件發(fā)送成功！共發(fā)送 " + to.length + " 個(gè)收件人";
    }
    // 測(cè)試：多收件人發(fā)送 HTML 郵件（實(shí)際場(chǎng)景常用，如批量營銷、通知）
    @GetMapping("/send/html/batch")
    public String sendBatchHtmlMail(
            @RequestParam String[] to,
            @RequestParam String subject
    ) throws MessagingException {
        // 復(fù)用注冊(cè)驗(yàn)證 HTML 模板，可根據(jù)實(shí)際需求修改
        String htmlContent = "<!DOCTYPE html>" +
                "<html lang='zh-CN'>" +
                "<body style='font-family: \"Microsoft YaHei\", sans-serif;'>" +
                "<h2 style='color: #1E90FF; text-align: center;'>批量通知郵件</h2>" +
                "<p style='font-size: 14px;'>各位用戶，您好！本次批量通知內(nèi)容如下：</p>" +
                "<p style='font-size: 14px; color: #333;'>系統(tǒng)將于今晚 23:00 進(jìn)行升級(jí)維護(hù)，維護(hù)期間可能無法正常使用，敬請(qǐng)諒解！</p>" +
                "<p style='font-size: 12px; color: #999; margin-top: 20px;'>此為系統(tǒng)批量發(fā)送郵件，請(qǐng)勿回復(fù)</p>" +
                "</body></html>";
        mailUtil.sendHtmlMail(to, subject, htmlContent);
        return "多收件人HTML郵件發(fā)送成功！共發(fā)送 " + to.length + " 個(gè)收件人";
    }
}