詳解java mail 發送郵件

電子郵件的應用非常廣泛，例如在某網站註冊了一個賬戶，自動發送一封歡迎郵件，通過郵件找回密碼，自動批量發送活動信息等。但這些應用不可能和我們自己平時發郵件一樣，先打開瀏覽器，登錄郵箱，創建郵件再發送。本文將簡單介紹如何通過 Java 代碼來創建電子郵件，並連接郵件服務器發送郵件。

1. 電子郵件協議

電子郵件的在網絡中傳輸和網頁一樣需要遵從特定的協議，常用的電子郵件協議包括 SMTP，POP3，IMAP。其中郵件的創建和發送只需要用到 SMTP協議，所以本文也只會涉及到SMTP協議。SMTP 是 Simple Mail Transfer Protocol 的簡稱，即簡單郵件傳輸協議。

2. JavaMail

我們平時通過 Java 代碼打開一個 http 網頁鏈接時，通常可以使用已經對 http 協議封裝好的 HttpURLConnection 類來快速地實現。Java 官方也提供了對電子郵件協議封裝的 Java 類庫，就是JavaMail，但並沒有包含到標準的 JDK 中，需要我們自己去官方下載，這裏我從 JavaEE 官方的 Github 倉庫下載。

JavaMail 下載地址: https://github.com/javaee/javamail/releases

這裏我下載的版本是 1.6.0 版本，包含了 SMTP, IMAP, 和 POP3 協議的實現的 jar 包:

我把 JavaMail 1.6.0 的 jar 包上傳到了 CSDN，如果無法從 Github 下載，可以從 CSDN 下載（建議到Github下載，CSDN上我設了積分）: http://download.csdn.net/download/xietansheng/9928266

特別注意:

• 本測試用例用的 JavaMail 版本是 1.6.0，如果下載到其他版本的 JavaMail 運行時出現問題，請使用 JavaMail 1.6.0 版本再進行嘗試。
• 使用 JavaMail 1.6.0 要求的 JDK 版本必須是 JDK 1.7 以上（建議使用最新版 JDK）。
• 不要直接就完完全全複製我的代碼，需要 修改一下發送的標題、內容、用戶暱稱，要不然所有人都直接複製我的代碼發送，內容一致，郵箱服務器就可能會檢測到這些內容是垃圾廣告內容，不讓你發送，會返回錯誤碼，查詢錯誤碼也能查詢到失敗原因。

有些童鞋反應代碼提示某些類找不到，或運行出現問題，往往都是 JDK 版本過低，或 JavaMail 版本過低，出現問題時 請使用推薦的版本。

再出現問題，只要能連接成功，都有錯誤碼返回，有些童鞋發送失敗在控制檯已經給出了錯誤碼，大部分還給出了查看錯誤碼含義的鏈接，點開鏈接，查詢對應的錯誤碼，爲什麼失敗，已經明明白白的告訴你了，針對失敗原因修改即可！

郵件發送，涉及多端（本地代碼端、郵件發送服務器端、郵件接收服務器端），保證自己的代碼沒問題了，不一定就能成功，你把你的郵件提交到郵件發送服務器，發送的服務器可以給你拒絕服務（比如認爲發送的內容是垃圾廣告，或者你頻繁請求發送），這不是代碼端能管的事情，但都有錯誤碼返回，明確告訴你爲什麼錯誤。就算你發送成功了，對方也有可能接收不到，成功發送到對方的郵件接收服務器後，對方的服務器可以根據你的內容拒絕收你的郵件（比如認爲你的內容是廣告詐騙等信息，或者發送過於頻繁），對方的服務器可能直接把你的郵件扔垃圾箱，或者直接忽略。出現這些問題，請修改發送的標題、內容、暱稱等，重複的內容不要反覆發送，或多更換收件箱和發件箱試試！！！

3. 創建一封簡單的電子郵件

首先創建一個 Java 工程，把下載好的 javax.mail.jar 作爲類庫加入工程，這裏不多說。

郵件創建步驟:

1. 創建一個郵件對象（MimeMessage）；
2. 設置發件人，收件人，可選增加多個收件人，抄送人，密送人；
3. 設置郵件的主題（標題）；
4. 設置郵件的正文（內容）；
5. 設置顯示的發送時間；
6. 保存到本地。

代碼實現:

package com.xiets.javamaildemo;

import javax.mail.Session;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;
import java.util.Properties;

/**
 * JavaMail 版本: 1.6.0
 * JDK 版本: JDK 1.7 以上（必須）
 */
public class Main {

    public static void main(String[] args) throws Exception {
        // 1. 創建一封郵件
        Properties props = new Properties();                // 用於連接郵件服務器的參數配置（發送郵件時才需要用到）
        Session session= Session.getInstance(props);        // 根據參數配置，創建會話對象（爲了發送郵件準備的）
        MimeMessage message = new MimeMessage(session);     // 創建郵件對象

        /*
         * 也可以根據已有的eml郵件文件創建 MimeMessage 對象
         * MimeMessage message = new MimeMessage(session, new FileInputStream("MyEmail.eml"));
         */

        // 2. From: 發件人
        //    其中 InternetAddress 的三個參數分別爲: 郵箱, 顯示的暱稱(只用於顯示, 沒有特別的要求), 暱稱的字符集編碼
        //    真正要發送時, 郵箱必須是真實有效的郵箱。
        message.setFrom(new InternetAddress("[email protected]", "USER_AA", "UTF-8"));

        // 3. To: 收件人
        message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress("[email protected]", "USER_CC", "UTF-8"));
        //    To: 增加收件人（可選）
        message.addRecipient(MimeMessage.RecipientType.TO, new InternetAddress("[email protected]", "USER_DD", "UTF-8"));
        //    Cc: 抄送（可選）
        message.setRecipient(MimeMessage.RecipientType.CC, new InternetAddress("[email protected]", "USER_EE", "UTF-8"));
        //    Bcc: 密送（可選）
        message.setRecipient(MimeMessage.RecipientType.BCC, new InternetAddress("[email protected]", "USER_FF", "UTF-8"));

        // 4. Subject: 郵件主題
        message.setSubject("TEST郵件主題", "UTF-8");

        // 5. Content: 郵件正文（可以使用html標籤）
        message.setContent("TEST這是郵件正文。。。", "text/html;charset=UTF-8");

        // 6. 設置顯示的發件時間
        message.setSentDate(new Date());

        // 7. 保存前面的設置
        message.saveChanges();

        // 8. 將該郵件保存到本地
        OutputStream out = new FileOutputStream("MyEmail.eml");
        message.writeTo(out);
        out.flush();
        out.close();
    }

}

• 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
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45
• 46
• 47
• 48
• 49
• 50
• 51
• 52
• 53
• 54
• 55
• 56
• 57
• 58
• 59
• 60
• 61

保存的 MyEmail.eml 可以使用郵件客戶端打開查看，實際上就是一堆符合SMTP協議格式的文本（內容使用base64進行了編碼），也可用記事本打開，如下所示:

4. 發送電子郵件

發送郵件首先需要有一個郵箱賬號和密碼，本文以網易163郵箱爲例，郵箱賬號必須要開啓 SMTP 服務，在瀏覽器網頁登錄郵箱後一般在郵箱的“設置”選項中可以開啓，並記下郵箱的 SMTP 服務器地址，如下所示（其他郵箱大同小異）:

代碼實現:

package com.xiets.javamaildemo;

import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Date;
import java.util.Properties;

/**
 * JavaMail 版本: 1.6.0
 * JDK 版本: JDK 1.7 以上（必須）
 */
public class Main {

    // 發件人的 郵箱 和 密碼（替換爲自己的郵箱和密碼）
    // PS: 某些郵箱服務器爲了增加郵箱本身密碼的安全性，給 SMTP 客戶端設置了獨立密碼（有的郵箱稱爲“授權碼”）, 
    //     對於開啓了獨立密碼的郵箱, 這裏的郵箱密碼必需使用這個獨立密碼（授權碼）。
    public static String myEmailAccount = "[email protected]";
    public static String myEmailPassword = "xxxxxxxxx";

    // 發件人郵箱的 SMTP 服務器地址, 必須準確, 不同郵件服務器地址不同, 一般(只是一般, 絕非絕對)格式爲: smtp.xxx.com
    // 網易163郵箱的 SMTP 服務器地址爲: smtp.163.com
    public static String myEmailSMTPHost = "smtp.163.com";

    // 收件人郵箱（替換爲自己知道的有效郵箱）
    public static String receiveMailAccount = "[email protected]";

    public static void main(String[] args) throws Exception {
        // 1. 創建參數配置, 用於連接郵件服務器的參數配置
        Properties props = new Properties();                    // 參數配置
        props.setProperty("mail.transport.protocol", "smtp");   // 使用的協議（JavaMail規範要求）
        props.setProperty("mail.smtp.host", myEmailSMTPHost);   // 發件人的郵箱的 SMTP 服務器地址
        props.setProperty("mail.smtp.auth", "true");            // 需要請求認證

        // PS: 某些郵箱服務器要求 SMTP 連接需要使用 SSL 安全認證 (爲了提高安全性, 郵箱支持SSL連接, 也可以自己開啓),
        //     如果無法連接郵件服務器, 仔細查看控制檯打印的 log, 如果有有類似 “連接失敗, 要求 SSL 安全連接” 等錯誤,
        //     打開下面 /* ... */ 之間的註釋代碼, 開啓 SSL 安全連接。
        /*
        // SMTP 服務器的端口 (非 SSL 連接的端口一般默認爲 25, 可以不添加, 如果開啓了 SSL 連接,
        //                  需要改爲對應郵箱的 SMTP 服務器的端口, 具體可查看對應郵箱服務的幫助,
        //                  QQ郵箱的SMTP(SLL)端口爲465或587, 其他郵箱自行去查看)
        final String smtpPort = "465";
        props.setProperty("mail.smtp.port", smtpPort);
        props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
        props.setProperty("mail.smtp.socketFactory.fallback", "false");
        props.setProperty("mail.smtp.socketFactory.port", smtpPort);
        */

        // 2. 根據配置創建會話對象, 用於和郵件服務器交互
        Session session = Session.getInstance(props);
        session.setDebug(true);                                 // 設置爲debug模式, 可以查看詳細的發送 log

        // 3. 創建一封郵件
        MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);

        // 4. 根據 Session 獲取郵件傳輸對象
        Transport transport = session.getTransport();

        // 5. 使用 郵箱賬號 和 密碼 連接郵件服務器, 這裏認證的郵箱必須與 message 中的發件人郵箱一致, 否則報錯
        // 
        //    PS_01: 成敗的判斷關鍵在此一句, 如果連接服務器失敗, 都會在控制檯輸出相應失敗原因的 log,
        //           仔細查看失敗原因, 有些郵箱服務器會返回錯誤碼或查看錯誤類型的鏈接, 根據給出的錯誤
        //           類型到對應郵件服務器的幫助網站上查看具體失敗原因。
        //
        //    PS_02: 連接失敗的原因通常爲以下幾點, 仔細檢查代碼:
        //           (1) 郵箱沒有開啓 SMTP 服務;
        //           (2) 郵箱密碼錯誤, 例如某些郵箱開啓了獨立密碼;
        //           (3) 郵箱服務器要求必須要使用 SSL 安全連接;
        //           (4) 請求過於頻繁或其他原因, 被郵件服務器拒絕服務;
        //           (5) 如果以上幾點都確定無誤, 到郵件服務器網站查找幫助。
        //
        //    PS_03: 仔細看log, 認真看log, 看懂log, 錯誤原因都在log已說明。
        transport.connect(myEmailAccount, myEmailPassword);

        // 6. 發送郵件, 發到所有的收件地址, message.getAllRecipients() 獲取到的是在創建郵件對象時添加的所有收件人, 抄送人, 密送人
        transport.sendMessage(message, message.getAllRecipients());

        // 7. 關閉連接
        transport.close();
    }

    /**
     * 創建一封只包含文本的簡單郵件
     *
     * @param session 和服務器交互的會話
     * @param sendMail 發件人郵箱
     * @param receiveMail 收件人郵箱
     * @return
     * @throws Exception
     */
    public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
        // 1. 創建一封郵件
        MimeMessage message = new MimeMessage(session);

        // 2. From: 發件人（暱稱有廣告嫌疑，避免被郵件服務器誤認爲是濫發廣告以至返回失敗，請修改暱稱）
        message.setFrom(new InternetAddress(sendMail, "某寶網", "UTF-8"));

        // 3. To: 收件人（可以增加多個收件人、抄送、密送）
        message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "XX用戶", "UTF-8"));

        // 4. Subject: 郵件主題（標題有廣告嫌疑，避免被郵件服務器誤認爲是濫發廣告以至返回失敗，請修改標題）
        message.setSubject("打折鉅惠", "UTF-8");

        // 5. Content: 郵件正文（可以使用html標籤）（內容有廣告嫌疑，避免被郵件服務器誤認爲是濫發廣告以至返回失敗，請修改發送內容）
        message.setContent("XX用戶你好, 今天全場5折, 快來搶購, 錯過今天再等一年。。。", "text/html;charset=UTF-8");

        // 6. 設置發件時間
        message.setSentDate(new Date());

        // 7. 保存設置
        message.saveChanges();

        return message;
    }

}

• 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
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45
• 46
• 47
• 48
• 49
• 50
• 51
• 52
• 53
• 54
• 55
• 56
• 57
• 58
• 59
• 60
• 61
• 62
• 63
• 64
• 65
• 66
• 67
• 68
• 69
• 70
• 71
• 72
• 73
• 74
• 75
• 76
• 77
• 78
• 79
• 80
• 81
• 82
• 83
• 84
• 85
• 86
• 87
• 88
• 89
• 90
• 91
• 92
• 93
• 94
• 95
• 96
• 97
• 98
• 99
• 100
• 101
• 102
• 103
• 104
• 105
• 106
• 107
• 108
• 109
• 110
• 111
• 112
• 113
• 114
• 115
• 116
• 117

發送後查看收件人的收件箱: