Java 郵件發送完整指南：JavaMail API 核心用法、HTML/附件/認證/SSL 實戰詳解

環境準備：JavaMail 依賴配置

發送郵件需引入 JavaMail API 與 Java Activation Framework (JAF)。JDK 9+ 已內置 JAF，JDK 8 需額外引入。

Maven 依賴

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>
<!-- JDK 8 需額外添加 -->
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
    <version>1.1.1</version>
</dependency>

或下載 JAR 包手動加入 Classpath：mail.jar、activation.jar。

核心對象體系

• Session：郵件會話，持有配置屬性、認證器，線程安全，可共用
• Message (MimeMessage)：郵件實體，包含頭信息、內容、附件
• Transport：傳輸協議實現（SMTP），發送郵件
• Store：接收協議實現（POP3/IMAP），本文不涉及
• Authenticator：認證器，提供用戶名/密碼

場景一：發送純文本郵件

public void sendTextMail(String to, String subject, String content) {
    Properties props = new Properties();
    props.put("mail.smtp.host", "smtp.example.com");
    props.put("mail.smtp.port", "25"); // 或 587 (TLS), 465 (SSL)
    props.put("mail.smtp.auth", "true");

    Session session = Session.getInstance(props, new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            return new PasswordAuthentication("username", "password");
        }
    });

    try {
        MimeMessage message = new MimeMessage(session);
        message.setFrom(new InternetAddress("from@example.com"));
        message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
        message.setSubject(subject);
        message.setText(content); // 純文本
        Transport.send(message);
    } catch (MessagingException e) {
        throw new RuntimeException("郵件發送失敗", e);
    }
}

場景二：發送 HTML 富文本郵件

message.setContent("<h1>歡迎註冊</h1><p>您的驗證碼：<strong>123456</strong></p>", "text/html;charset=UTF-8");

• 使用 setContent(Object, String) 設置 MIME 類型為 text/html
• 指定 charset=UTF-8 防止中文亂碼
• 支持內嵌 CSS、圖片 (CID)、表格等豐富排版

場景三：發送帶附件郵件

// 1. 創建文本部分
MimeBodyPart textPart = new MimeBodyPart();
textPart.setContent("詳細內容請查看附件", "text/html;charset=UTF-8");

// 2. 創建附件部分
MimeBodyPart filePart = new MimeBodyPart();
DataSource source = new FileDataSource(new File("/path/to/report.pdf"));
filePart.setDataHandler(new DataHandler(source));
filePart.setFileName(MimeUtility.encodeText("月度報告.pdf")); // 編碼中文文件名

// 3. 組裝 Multipart
MimeMultipart multipart = new MimeMultipart();
multipart.addBodyPart(textPart);
multipart.addBodyPart(filePart);

// 4. 設置到 Message
message.setContent(multipart);

多附件：重複步驟 2-3 添加多個 MimeBodyPart。

內嵌圖片：附件部分設置 filePart.setHeader("Content-ID", "<logo>")，HTML 中引用 <img src="cid:logo">。

場景四：QQ 郵箱 / 163 / Gmail 等第三方 SMTP 實戰

QQ 郵箱配置步驟

1. 登錄 QQ 郵箱網頁版 → 設置 → 賬號 → 開啟 POP3/SMTP 服務、IMAP/SMTP 服務
2. 獲取 授權碼（非登錄密碼），用於 SMTP 認證
3. SMTP 服務器：smtp.qq.com，端口：465 (SSL) 或 587 (TLS)

完整代碼（SSL 連接）

public void sendQQMail(String to, String subject, String content) {
    Properties props = new Properties();
    props.put("mail.smtp.host", "smtp.qq.com");
    props.put("mail.smtp.port", "465");
    props.put("mail.smtp.auth", "true");
    props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
    props.put("mail.smtp.socketFactory.port", "465");
    // TLS 方案 (端口 587)
    // props.put("mail.smtp.starttls.enable", "true");

    Session session = Session.getInstance(props, new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            return new PasswordAuthentication("your_qq@qq.com", "授權碼");
        }
    });

    try {
        MimeMessage message = new MimeMessage(session);
        message.setFrom(new InternetAddress("your_qq@qq.com", "發件人昵稱", "UTF-8"));
        message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
        message.setSubject(subject, "UTF-8");
        message.setContent(content, "text/html;charset=UTF-8");
        Transport.send(message);
        System.out.println("發送成功");
    } catch (MessagingException | UnsupportedEncodingException e) {
        throw new RuntimeException("QQ郵件發送失敗", e);
    }
}

常用 SMTP 服務器配置參考表

進階主題與最佳實踐

異步發送與線程池

@Async("mailExecutor")
public void sendAsync(MailRequest request) {
    sendMail(request);
}

// 配置線程池
@Bean
public ThreadPoolTaskExecutor mailExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setCorePoolSize(5);
    executor.setMaxPoolSize(20);
    executor.setQueueCapacity(100);
    executor.setThreadNamePrefix("mail-sender-");
    return executor;
}

郵件模板引擎

整合 Thymeleaf/FreeMarker/Velocity，分離業務邏輯與模板：

@Autowired private TemplateEngine templateEngine;

public String buildHtml(String templateName, Context context) {
    return templateEngine.process(templateName, context);
}

批量發送優化

• 復用 Session 和 Transport 連接
• Transport.connect() → 循環 transport.sendMessage() → transport.close()
• 大批量建議接入專業郵件服務：SendGrid、Amazon SES、阿里云郵件推送

彈回/退信處理

• 設置 Return-Path / Disposition-Notification-To 頭
• 配置專門郵箱接收彈回，定期解析清理無效地址

安全與合規

• 嚴禁硬編碼密碼，使用配置中心/密鑰管理系統
• 啟用 SPF、DKIM、DMARC 域名認證，提高送達率
• 遵守《郵件營銷管理規範》，提供退訂鏈接，控制發送頻率

常見問題排查

總結

JavaMail API 提供了完整、標準的郵件發送能力。掌握 Session/Message/Transport 核心三件套、MimeMultipart 組裝複雜內容、SSL/TLS 安全傳輸、異步化/模板化/批量化 工程化實踐，能構建穩定、高效、合規的郵件通知系統。現代項目建議封裝為通用 MailService 組件，接入配置中心、監控告警、鏈路追蹤，作為基礎設施服務提供給上層業務調用。