JavaMail 發送郵件實戰避坑：從未知主機到 SSL 端口誤用

前言

JavaMail 發送郵件看似簡單，實則暗藏 DNS 解析、端口協議、SSL/TLS 協商等網絡層陷阱。本文記錄一次從「Unknown SMTP host」到「Could not connect to SMTP host」的排查全過程，揭示 MailSSLSocketFactory 強制啟用 SSL 導致端口不匹配的核心坑點。

一、現象複現

1.1 環境

• 應用部署於 Linux 服務器
• 郵箱：中國移動企業郵箱 mail.chinamobilesz.com
• 依賴：javax.mail:mail:1.4.7

1.2 首報錯誤

javax.mail.MessagingException: Unknown SMTP host: mail.chinamobilesz.com
    at com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:1959)

分析：DNS 解析失敗。Linux 服務器 /etc/hosts 無該域名映射，且 DNS 服務器未生效。

1.3 臨時繞過

在 /etc/hosts 添加 IP mail.chinamobilesz.com 映射後，telnet mail.chinamobilesz.com 25 連通，但 Java 程式仍報錯：

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

明明 25 端口通，為什麼 Java 連不上？

二、根因定位：隱性 SSL 配置劫持端口

2.1 代碼排查

項目郵件工具類中發現如下片段：

// SSL加密
MailSSLSocketFactory sf = new MailSSLSocketFactory();
sf.setTrustAllHosts(true);
props.put("mail.smtp.ssl.enable", "true");
props.put("mail.smtp.ssl.socketFactory", sf);

2.2 機制揭秘

• mail.smtp.ssl.enable=true：JavaMail 會**忽略**默認 25 端口，改用 **465 端口**（SMTPS 隱式 SSL）。
• MailSSLSocketFactory：自定義 SSL Socket 工廠，繞過證書驗證（setTrustAllHosts）。
• 移動郵箱**未開放 465 端口**，僅支持 25 端口（明文或 STARTTLS 顯式 TLS）。

結論：代碼強制啟用隱式 SSL，導致客戶端嘗試連 465 端口，服務端無此端口，連接超時拋出「Could not connect... port: 25」（錯誤信息誤導，實際嘗試 465）。

三、解決方案

3.1 移除 SSL 強制配置

刪除上述 MailSSLSocketFactory 相關代碼，恢復默認 25 端口明文/STARTTLS 協商。

3.2 如需加密：啟用 STARTTLS（顯式 TLS）

props.put("mail.smtp.starttls.enable", "true"); // 25/587 端口升級 TLS
props.put("mail.smtp.starttls.required", "true"); // 強制要求 TLS

此模式下客戶端連 25 端口，通過 SMTP STARTTLS 指令協商升級加密通道，兼容性最佳。

3.3 信任自簽證書（若服務器證書不可信）

// 僅在 STARTTLS 模式下需自定義 SocketFactory
props.put("mail.smtp.ssl.trust", "mail.chinamobilesz.com"); // JDK 1.8+ 支持
// 或繼續用 MailSSLSocketFactory 但配合 starttls.enable

四、JavaMail 協議/端口對照表

五、排查檢查清單

1. DNS/Hosts：服務器能否解析郵件域名？telnet host 25 是否通？
2. 防火牆/安全組：出站 25/465/587 端口是否放行？雲廠商常默認封禁 25 端口。
3. 協議匹配：郵箱服務商支持哪種加密模式？勿盲目複製 SSL 代碼。
4. 認證方式：是否需要 AUTH LOGIN/PLAIN/OAUTH2？props.put("mail.smtp.auth", "true")。
5. 異常信息解讀：「port: 25」不代表真正連 25，需結合 SSL 配置綜合判斷。

六、總結

JavaMail 發送郵件的核心難點不在 API，而在於**網絡協議與服務商能力的匹配**。理解 SMTP/SMTPS/STARTTLS 三種模式的端口與握手差異，配合 telnet/openssl s_client 驗證連通性，才能快速定位「連不上」的真凶。