JavaMail 郵箱自動驗證功能實戰：從 163/QQ 郵箱配置到常見異常排查全記錄

核心發送代碼實現

package com.app.tools;

import java.util.Date;
import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;

public class SendEmail {
    // 163 郵箱配置
    public static final String HOST = "smtp.163.com";
    public static final String PROTOCOL = "smtp";
    public static final int PORT = 25;           // 163 使用 25 端口
    public static final String FROM = "your_email@163.com";  // 發件郵箱
    public static final String PWD = "your_auth_code";       // 客戶端授權碼（非登錄密碼！）

    private static Session getSession() {
        Properties props = new Properties();
        props.put("mail.smtp.host", HOST);
        props.put("mail.store.protocol", PROTOCOL);
        props.put("mail.smtp.port", PORT);
        props.put("mail.smtp.auth", "true");     // 必須為字符串 "true"
        
        Authenticator auth = new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(FROM, PWD);
            }
        };
        return Session.getDefaultInstance(props, auth);
    }

    public static void send(String toEmail, String htmlContent) {
        Session session = getSession();
        try {
            MimeMessage msg = new MimeMessage(session);
            msg.setFrom(new InternetAddress(FROM));
            msg.setRecipients(Message.RecipientType.TO, 
                InternetAddress.parse(toEmail));
            msg.setSubject("賬號激活郵件");
            msg.setSentDate(new Date());
            msg.setContent(htmlContent, "text/html;charset=utf-8");
            
            Transport.send(msg);
            System.out.println("郵件發送成功：" + toEmail);
        } catch (MessagingException e) {
            e.printStackTrace();
            throw new RuntimeException("郵件發送失敗", e);
        }
    }

    public static void main(String[] args) {
        String html = "<h1>歡迎註冊</h1><p>點擊鏈接激活：<a href='https://xxx.com/activate?token=abc'>激活賬號</a></p>";
        send("target@qq.com", html);
    }
}

四大核心配置陷阱（必看避坑指南）

1. 必須開啟 SMTP 服務並獲取授權碼

無論 163 還是 QQ 郵箱，登錄密碼不能直接用於 SMTP 認證，必須在郵箱設置中開啟「SMTP/IMAP/POP3 服務」並獲取獨立授權碼。

2. 連接超時異常

javax.mail.MessagingException: Could not connect to SMTP host: smtp.163.com, port: 25

排查清單：

• 網絡是否通：telnet smtp.163.com 25 或 nc -zv smtp.163.com 25
• 企業/雲服務器安全組是否放行 25 端口出站（阿里雲/騰訊雲默認封禁 25 端口，需申請解封或使用 465/587 端口）
• 本地防火牆/殺毒軟件攔截
• 關鍵配置：props.put("mail.smtp.auth", "true") 值必須為字符串 "true"，非 boolean true，否則可能拋出「需要認證」異常

3. 郵箱服務商端口與主機對照表

SSL 連接額外配置（以 465 端口為例）：

props.put("mail.smtp.port", "465");
props.put("mail.smtp.socketFactory.port", "465");
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.put("mail.smtp.socketFactory.fallback", "false");

4. 認證失敗異常

javax.mail.AuthenticationFailedException

常見原因：

1. 授權碼錯誤/過期（QQ 郵箱授權碼有效期通常 1 年）
2. 郵箱賬號處於異常狀態（被盜鎖定、長期未登錄凍結）
3. 使用了登錄密碼而非授權碼
4. 163 郵箱：授權碼生成後需在「客戶端授權密碼」區域查看

5. QQ 郵箱發送頻率限制

QQ 郵箱對單賬號發送頻率有嚴格限制（如每小時 20 封、每天 100 封）。測試階段建議：

• 使用 163 郵箱測試（限制相對寬鬆）
• 間隔 30 秒以上發送
• 生產環境建議使用專業郵件服務商（SendCloud、阿里云邮件推送、Amazon SES）

進階優化建議

1. 異步發送：使用 @Async 或消息隊列剝離發送耗時
2. 模板引擎：Thymeleaf/Freemarker 渲染 HTML 內容，分離業務與展現
3. 重試機制：指數退避重試 3 次，記錄失敗日志供人工補發
4. 發送狀態追蹤：記錄 Message-ID、發送時間、狀態（成功/失敗/退信）
5. 連接池：Session 線程不安全，高併發場景使用 javax.mail.Session 無連接池特性，建議封裝連接池或使用 Spring JavaMailSender

完整依賴坐標

<!-- Maven -->
<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>2.0.1</version>
</dependency>

<!-- 或舊版本 -->
<dependency>
    <groupId>javax.mail</groupId>
    <artifactId>mail</artifactId>
    <version>1.4.7</version>
</dependency>