Java 發送 Outlook 預製郵件：基於 EML 檔案的簡化郵件發送方案

場景痛點

業務系統常需發送格式複雜的郵件（HTML 排版、內嵌圖片、附件、多收件人）。若在程式碼中手工構建 MimeMessage，程式碼冗長且難維護。本文介紹一種「所見即所得」方案：先用 Outlook 編寫郵件存為 .eml，再由 Java 直接發送。

核心實現

import java.io.FileInputStream;
import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;

public class SendOutlookEmail {
    public static void main(String[] args) throws Exception {
        // 1. 郵件伺服器配置
        Properties props = new Properties();
        props.setProperty("mail.smtp.auth", "true");
        props.setProperty("mail.transport.protocol", "smtp");
        props.setProperty("mail.host", "smtp.sina.com"); // 替換為實際 SMTP

        // 2. 建立帶認證的 Session
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication("your_account", "your_password");
            }
        });
        session.setDebug(true); // 開啟除錯輸出

        // 3. 直接載入 Outlook 儲存的 .eml 檔案
        Message msg = new MimeMessage(session, 
            new FileInputStream("resource/demo3.eml"));

        // 4. 發送（收件人已包含在 EML 中，亦可程式指定）
        Transport.send(msg, InternetAddress.parse("recipient@example.com"));
    }
}

.eml 檔案獲取方式

1. Outlook 中編寫完整郵件（含格式、圖片、附件）
2. 選擇「檔案」→「另存為」→ 類型選「Outlook 郵件格式 (*.msg)」或「通用郵件格式 (*.eml)」
3. 若存為 .msg，需先轉換為 .eml（Outlook 拖曳到資料夾自動轉換，或用工具）
4. 將 .eml 放入專案資源目錄（如 src/main/resources/emails/）

進階用法：動態參數替換

若需在固定模板中插入動態內容（如用戶名、驗證碼），可採用模板引擎：

// 讀取 EML 為字串
String emlContent = new String(Files.readAllBytes(Paths.get("template.eml")), "UTF-8");

// 簡單佔位符替換（生產建議用 FreeMarker/Thymeleaf）
emlContent = emlContent.replace("${username}", "張三")
                       .replace("${code}", "123456");

// 解析為 MimeMessage
MimeMessage msg = new MimeMessage(session, 
    new ByteArrayInputStream(emlContent.getBytes("UTF-8")));

優缺點分析

生產環境建議

• 資源載入：使用 getClass().getResourceAsStream("/emails/template.eml") 替代檔案路徑
• 連線池：配置 mail.smtp.connectionpool 或使用 Spring Mail 整合
• 非同步發送：結合 @Async 或訊息佇列避免阻塞業務線程
• 錯誤重試：實現指數退避重試機制，記錄失敗郵件供人工補發

總結

「Outlook 編寫 + Java 發送 EML」是處理複雜郵件場景的實用折中方案：發揮圖形化工具優勢設計樣板，利用 JavaMail 標準 API 可靠投遞。配合模板引擎實現動態化，可大幅降低郵件開發維護成本。