1. 項目概述1.1 這個需求背后的真實場景說到Java Web發(fā)郵件很多剛?cè)胄械耐瑢W第一反應是拿個Spring Boot項目加個starter填幾個配置一個JavaMailSender注入進來就能跑了。但如果你還在學原生Servlet、JSP的老一套技術(shù)棧或者你所在項目有盡量不引入框架依賴的約束那原生Java Web實現(xiàn)郵件發(fā)送這個需求就會突然變得不那么輕松。我這次做的東西就是在這個背景下展開的一個純Servlet JavaMail API實現(xiàn)的郵件發(fā)送功能頁面提交表單后端接到請求后通過SMTP協(xié)議把郵件發(fā)出去。沒有Spring沒有Maven插件沒有一堆自動配置每一步都手動拼起來。這種做法的價值在于它能讓你真正理解一封郵件從瀏覽器表單到對方收件箱之間到底經(jīng)歷了哪些環(huán)節(jié)而不是被框架的黑盒隱藏起來。這套代碼適合誰參考三類人第一類是正在學Java Web、想搞明白Servlet如何承接請求并完成任務的同學第二類是在校做課程設(shè)計、需要一個完整可演示的郵件發(fā)送模塊的開發(fā)者第三類是工作中遇到了不能用框架、必須原生實現(xiàn)這種約束需要快速落地的工程師?？赐赀@篇文章你能拿到可以直接跑起來的源碼也能明白文件編碼問題、SMTP認證失敗、端口不通這些坑是怎么踩出來的。1.2 準備聊哪些內(nèi)容文章會分為這樣幾個部分先說郵件發(fā)送涉及的基礎(chǔ)知識——SMTP協(xié)議是什么、JavaMail API和它的依賴關(guān)系然后講我如何規(guī)劃項目結(jié)構(gòu)和關(guān)鍵配置接著給出完整源碼逐段拆解發(fā)送邏輯再聊Servlet如何接入Http請求以及JSP頁面上的表單細節(jié)最后把實際開發(fā)中遇到的典型問題和排查思路整理成清單。每個段落都會附帶我在動手過程中的實際操作記錄和經(jīng)驗體會不是純理論都是可復現(xiàn)的步驟。2. 郵件發(fā)送的核心機制與JavaMail選型2.1 SMTP協(xié)議到底是干什么的郵件發(fā)送這件事本質(zhì)上就是你的程序作為郵件客戶端把一封構(gòu)造好的郵件扔給一臺SMTP服務器再由這臺服務器負責把郵件投遞到收件人的郵件服務器上。整個過程遵循SMTP協(xié)議——Simple Mail Transfer Protocol簡單郵件傳輸協(xié)議。它定義了兩臺服務器之間、客戶端與服務器之間的對話規(guī)則。你可以把SMTP服務器想象成一個快遞中轉(zhuǎn)站。你寫好了包裹郵件填好了收件人地址收件郵箱然后把它交給中轉(zhuǎn)站SMTP服務器中轉(zhuǎn)站根據(jù)地址去投遞。如果收件人郵箱恰好也在同一家中轉(zhuǎn)站的管轄范圍那它直接投進對方信箱如果不在它會轉(zhuǎn)交給下一個中轉(zhuǎn)站。發(fā)郵件這個動作從用戶視角看只是點了發(fā)送按鈕但背后經(jīng)歷了至少一次TCP連接、一次身份認證通常需要、一次郵件數(shù)據(jù)傳輸。第三方免費郵箱提供的SMTP服務器通常會在服務器上開一個認證機制。你用自己的郵箱賬號去登錄對方服務器通過驗證之后才允許發(fā)信。這也是為什么實際開發(fā)中你幾乎不可能只寫代碼就能把郵件發(fā)出去——你必須有一個真實的、開啟了SMTP服務權(quán)限的郵箱賬戶。大多數(shù)主流郵箱廠商默認不開放這個功能需要你手動在設(shè)置里開啟SMTP/POP3/IMAP服務然后生成一個授權(quán)碼而非直接使用登錄密碼。這個細節(jié)非常關(guān)鍵我第一次測試時用賬號密碼直接認證服務器返回535錯誤查了半天才意識到要用授權(quán)碼。2.2 JavaMail API的結(jié)構(gòu)與依賴Java原生發(fā)郵件依賴的核心API是javax.mail包這是JavaEE規(guī)范中JavaMail的一部分。它不是JDK自帶的需要額外引入兩個JAR包mail.jar提供Session、Message、Transport等主要類activation.jar處理MIME類型數(shù)據(jù)的輔助包比如附件、圖片內(nèi)嵌這類二進制的數(shù)據(jù)如果你的項目用Maven管理依賴引入這兩個坐標就行但如果是原生Servlet項目、沒有Maven那你得手動把JAR包放在WEB-INF/lib目錄下。我在開發(fā)時使用的是最傳統(tǒng)的手動部署方式——自己在本地下載了mail.jar和activation.jar放在lib目錄然后讓Tomcat在啟動時加載它們。這種方式的好處是完全可控不用依賴網(wǎng)絡(luò)構(gòu)件倉庫對課程設(shè)計或者內(nèi)網(wǎng)開發(fā)環(huán)境非常友好。JavaMail API工作的核心對象有三個Session整個郵件會話的配置中心持有服務器地址、端口、認證開關(guān)、網(wǎng)絡(luò)超時這些參數(shù)MimeMessage代表一封郵件負責組裝發(fā)件人、收件人、主題、正文、附件Transport真正把MimeMessage發(fā)給SMTP服務器并完成數(shù)據(jù)傳輸?shù)耐ǖ肋@三者的關(guān)系可以簡化理解為一個類似快遞流程你(Session)約好了快遞公司SMTP服務器的規(guī)矩填好快遞單MimeMessage然后交給快遞員Transport帶走。在后面的代碼部分你就能看到這三者依次登場。2.3 為什么不用第三方SDK而自己寫現(xiàn)在很多云服務商提供了HTTP接口發(fā)郵件的SDK比如通過API密鑰調(diào)用發(fā)信接口代碼量更小、送達率也更高。那為什么我這次堅持用原生JavaMail原因很簡單題目要求是原生JavaWeb實現(xiàn)這是技術(shù)學習路徑上必須走的一步。用云服務商的SDK屏蔽了底層的SMTP交互學習價值大打折扣。而手工寫JavaMail代碼你能看清SMTP服務器的連接是Socket層面的TCP通信郵件內(nèi)容本質(zhì)上是MIME格式的文本數(shù)據(jù)附件是多段MIME結(jié)構(gòu)拼接起來的這些底層認知對于將來調(diào)試復雜的郵件問題——比如附件格式錯亂、郵件被識別為垃圾內(nèi)容——會提供很大的幫助。當然如果項目上線到生產(chǎn)環(huán)境我的建議還是優(yōu)先用成熟的郵件服務商或者企業(yè)內(nèi)部郵件服務器原生JavaMail更適合學習和可控的自建場景。后者在投遞成功率、反垃圾評分上靠的是背后整個基礎(chǔ)設(shè)施的積累。3. 項目結(jié)構(gòu)和基礎(chǔ)配置準備3.1 項目目錄怎么組織我這次的項目結(jié)構(gòu)完全按照Servlet規(guī)范的標準布局來沒有多余的花架子。核心文件有這些mail-demo/ ├── src/ │ └── com/example/mail/ │ ├── MailSender.java // 郵件發(fā)送核心邏輯 │ ├── SendMailServlet.java // 接收表單請求的Servlet │ └── MailConfig.java // 郵件配置常量服務器、賬號、授權(quán)碼 ├── web/ │ ├── WEB-INF/ │ │ ├── lib/ │ │ │ ├── mail.jar │ │ │ └── activation.jar │ │ └── web.xml │ └── sendMail.jsp // 發(fā)送頁面這個結(jié)構(gòu)是手動建出來的沒有用IDE的Web項目向?qū)АＶ允謩哟钍且驗楹芏喑鯇W者在IDE里點新建Dynamic Web Project時會面臨各種版本兼容的選項錯誤反而不如自己動手創(chuàng)建目錄、自己寫web.xml來得清晰。當然你在IDEA里用Project Structure新建Web項目也是可以的只要保證最終部署出來的目錄結(jié)構(gòu)滿足Servlet規(guī)范即可。還有一點要提前說清楚WEB-INF目錄下的東西是Web容器保護的外部不能通過URL直接訪問。所以mail.jar和activation.jar放在WEB-INF/lib下能被Tomcat自動加載而用戶無法通過http://ip:8080/mail-demo/mail.jar下載到它。這個機制是Servlet規(guī)范定義的保證依賴庫的私密性。3.2 需要的JAR包怎么獲取前面提到的兩個JAR包獲取途徑很常規(guī)。mail.jar可以在Oracle官網(wǎng)的JavaMail頁面下載也可以從Maven中央倉庫直接下載jar包文件。activation.jar同樣可以在Maven中央倉庫獲取搜索javax.activation即可。需要注意的是版本問題JavaMail版本建議選1.4.7這是公認穩(wěn)定且資料多的版本activation建議選1.1.1。高版本的jakarta.mail是另一套命名空間jakarta.mail包跟傳統(tǒng)的javax.mail不兼容如果項目還是老式Servlet容器Tomcat 8/9那用javax.mail的命名空間就夠了不用追新。如果你用的是Maven直接在pom.xml中配置dependency groupIdjavax.mail/groupId artifactIdmail/artifactId version1.4.7/version /dependency dependency groupIdjavax.activation/groupId artifactIdactivation/artifactId version1.1.1/version /dependency這里有一個容易踩的坑不同版本的mail.jar依賴的activation.jar版本可能不同如果不匹配運行時會出現(xiàn)ClassNotFoundException: com.sun.activation.registries.MailcapFile這類錯誤。我自己的做法是干脆兩個JAR都從同一個來源下載比如Maven倉庫中的配套版本避免版本錯位。3.3 關(guān)鍵配置參數(shù)解釋在做郵件發(fā)送之前先要摸清你選擇的郵箱服務商提供的基礎(chǔ)參數(shù)。不同的郵件服務商SMTP服務器地址和端口可能不一樣常見的配置模式有普通SSL加密模式smtp.xxx.com端口465需要開啟SSL升級TLS模式smtp.xxx.com端口587需要STARTTLS我實際操作時優(yōu)先使用465端口SSL模式因為587端口在有些服務器環(huán)境下會被運營商封鎖或者郵件服務商默認不允許非加密連接。465這種SSL直連模式更省事只需要在Properties設(shè)置mail.smtp.ssl.enabletrue即可。除了服務器和端口還要準備好你的完整郵箱地址作為發(fā)件人地址授權(quán)碼在郵箱設(shè)置中開啟SMTP后生成的一串獨立密碼收件人郵箱測試時最好用另一個不同域名下的郵箱這樣能驗證跨服務器投遞是否正常我給項目加了一個MailConfig類來統(tǒng)一存放這些常量避免在代碼里到處寫死。這個問題雖然簡單但做得好不好直接影響后面維護的體驗——我見過不少項目把郵箱密碼散落在七八個類里改一次授權(quán)碼要全局搜索非常痛苦。4. 核心代碼實現(xiàn)詳解4.1 MailSender類——郵件發(fā)送的骨架先給出這個類的完整代碼這是整個項目中最核心的部分package com.example.mail; import java.util.Properties; import javax.mail.Authenticator; import javax.mail.Message; import javax.mail.MessagingException; import javax.mail.PasswordAuthentication; import javax.mail.Session; import javax.mail.Transport; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; public class MailSender { public static void send(String to, String subject, String content) throws MessagingException { Properties props new Properties(); // SMTP服務器地址 props.put(mail.smtp.host, MailConfig.SMTP_HOST); // 端口 props.put(mail.smtp.port, MailConfig.SMTP_PORT); // 是否開啟認證 props.put(mail.smtp.auth, true); // 是否開啟SSL props.put(mail.smtp.ssl.enable, true); // 設(shè)置超時時間避免服務器無響應時客戶端卡死 props.put(mail.smtp.connectiontimeout, 10000); props.put(mail.smtp.timeout, 10000); Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(MailConfig.USERNAME, MailConfig.AUTH_CODE); } }); // 打開調(diào)試模式方便觀察SMTP協(xié)議交互過程 session.setDebug(true); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(MailConfig.USERNAME)); message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); message.setSubject(subject, UTF-8); message.setContent(content, text/html;charsetUTF-8); Transport.send(message); } }這段代碼里值得逐行解釋的地方不少。先看Session.getInstance(props, authenticator)這一行props里配置了連接SMTP的所有參數(shù)而Authenticator是JavaMail用來獲取認證憑據(jù)的接口。注意看我在這里返回的不是郵箱的登錄密碼而是AUTH_CODE授權(quán)碼。這個設(shè)計是JavaMail API的標準用法——通過PasswordAuthentication封裝用戶名和密碼/授權(quán)碼Transport在連接服務器時會自動使用這組憑據(jù)做認證。再看message.setSubject(subject, UTF-8)。這個方法的重載形式很多如果你直接調(diào)用setSubject(subject)主題會按默認編碼處理中文大概率變成亂碼。我特意指定了UTF-8確保中英文都能正確編碼。同理正文通過setContent(content, text/html;charsetUTF-8)設(shè)置告訴收件人的郵件客戶端這是一封HTML格式、UTF-8編碼的郵件。如果你想要純文本格式把第二個參數(shù)改成text/plain;charsetUTF-8就行。還有一個容易被忽略的細節(jié)session.setDebug(true)。這行代碼平時沒存在感但當你遇到郵件發(fā)不出去這種問題需要排查時它會幫你打印出客戶端和SMTP服務器之間的完整對話過程——包括DNS解析、TCP連接、EHLO指令、AUTH LOGIN認證、MAIL FROM指令、RCPT TO指令、DATA指令以及服務器的每個響應碼。我第一次排查認證失敗問題時就是依靠這個輸出看到了服務器返回的錯誤碼才定位到授權(quán)碼的問題。上線部署時記得把setDebug改成false否則會產(chǎn)生大量日志輸出。4.2 MailConfig類——統(tǒng)一管理配置有經(jīng)驗的人寫代碼不會把配置參數(shù)分散在業(yè)務代碼里。我單獨抽了個MailConfig類package com.example.mail; public class MailConfig { // SMTP服務器地址 public static final String SMTP_HOST smtp.yourmailservice.com; // 端口SSL加密連接常用465 public static final String SMTP_PORT 465; // 發(fā)件人郵箱地址 public static final String USERNAME your_accountexample.com; // 授權(quán)碼不是登錄密碼 public static final String AUTH_CODE xxxxxxxxxxxxxx; }這個類的作用不言自明當你的部署環(huán)境切換時比如從測試郵箱切換到公司內(nèi)部郵件服務器只需要改這一個文件當授權(quán)碼過期需要替換時也只需要改這一個地方。這里有個建議如果你要把項目推到Git倉庫上務必在.gitignore中排除這個文件或者在提交前將真實授權(quán)碼替換成占位符——否則授權(quán)碼泄露別人就能用你的郵箱發(fā)郵件輕則被當作垃圾郵件源重則影響郵箱安全。4.3 SendMailServlet——接收請求的核心入口Servlet在Java Web開發(fā)中扮演的角色就是接受HTTP請求、執(zhí)行業(yè)務邏輯、返回響應視圖。我這里創(chuàng)建了一個SendMailServlet只負責接收頁面表單的POST請求并調(diào)用MailSenderpackage com.example.mail; import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; WebServlet(/sendMail) public class SendMailServlet extends HttpServlet { private static final long serialVersionUID 1L; Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); response.setContentType(text/html;charsetUTF-8); String to request.getParameter(to); String subject request.getParameter(subject); String content request.getParameter(content); if (to null || to.trim().isEmpty() || subject null || subject.trim().isEmpty()) { request.setAttribute(message, 收件人、主題不能為空); request.getRequestDispatcher(sendMail.jsp).forward(request, response); return; } try { MailSender.send(to.trim(), subject.trim(), content); request.setAttribute(message, 郵件發(fā)送成功); } catch (Exception e) { e.printStackTrace(); request.setAttribute(message, 郵件發(fā)送失敗 e.getMessage()); } request.getRequestDispatcher(sendMail.jsp).forward(request, response); } }注意編碼問題我在doPost第一行就設(shè)置了request.setCharacterEncoding(UTF-8)。這個調(diào)用必須在讀取任何請求參數(shù)之前執(zhí)行否則Tomcat會按默認的ISO-8859-1來解碼POST請求體中文表單提交就會出現(xiàn)亂碼。這個細節(jié)初學者特別容易踩坑——我見過很多人在頁面已經(jīng)設(shè)置了UTF-8但后臺收到的參數(shù)依然是亂碼的情況原因就是漏了這行。另外我做了基本的非空校驗只校驗了收件人和主題沒對郵箱格式做正則校驗。正常開發(fā)中收件人格式校驗是很基本的——郵箱里注入垃圾內(nèi)容導致發(fā)信失敗事小如果將來做批量發(fā)送功能格式錯誤可能引發(fā)異常退信。后面在升級篇中我會展示一個簡單的驗證方式。4.4 sendMail.jsp——前端提交界面最后需要一個交互頁面。我這里用JSP實現(xiàn)通過簡單的HTML表單提交數(shù)據(jù)% page contentTypetext/html;charsetUTF-8 languagejava % html head title郵件發(fā)送/title style body { font-family: Microsoft YaHei, sans-serif; background: #f5f5f5; } .container { width: 600px; margin: 50px auto; background: #fff; padding: 30px; border-radius: 8px; } label { display: block; margin-top: 15px; font-weight: bold; } input[typetext], textarea { width: 100%; padding: 8px; margin-top: 5px; border: 1px solid #ccc; border-radius: 4px; } textarea { height: 120px; } button { margin-top: 20px; padding: 10px 30px; background: #409eff; color: #fff; border: none; border-radius: 4px; cursor: pointer; } /style /head body div classcontainer h2發(fā)送郵件/h2 p stylecolor: red;${message}/p form actionsendMail methodpost label收件人郵箱/label input typetext nameto placeholdersomeoneexample.com label郵件主題/label input typetext namesubject placeholder郵件主題 label郵件內(nèi)容/label textarea namecontent placeholder請輸入郵件正文內(nèi)容/textarea button typesubmit發(fā)送/button /form /div /body /html表單的提交方式必須是post因為郵件發(fā)送會改變服務器狀態(tài)而且郵件主題和正文可能包含較長的內(nèi)容POST在數(shù)據(jù)大小限制和語義上都更合適。表單的action指向sendMail這個映射在Servlet代碼中是通過WebServlet(/sendMail)注解定義的——如果用低版本的Servlet容器注解可能不支持你需要再去web.xml里聲明Servlet映射我這次使用的是Servlet 3.0直接走注解。頁面上用了${message}來顯示后端返回的結(jié)果這要求JSP默認支持EL表達式。大部分Tomcat配置都是支持的如果顯示原樣${message}那是開了忽略EL的配置可以在JSP頂部加% page isELIgnoredfalse %解決。5. 部署運行與完整驗證流程5.1 部署到Tomcat部署過程我是這樣操作的先確保本地已經(jīng)安裝了Tomcat 8或9然后把整個項目導出為WAR包或者直接把項目目錄丟到Tomcat的webapps目錄下。如果你用的是IDEA可以在Run Configuration里配置Tomcat Server把項目部署到Tomcat后點擊運行。啟動過程中有幾點要特別注意Tomcat啟動時會在日志中打印部署信息如果WEB-INF/lib下的JAR包沒有正確加載你會看到ClassNotFoundException異常那多半是lib目錄路徑不對或者JAR包缺失如果出現(xiàn)端口占用檢查是否有其他Tomcat實例在運行可以在conf/server.xml中改端口瀏覽器訪問路徑通常是http://localhost:8080/mail-demo/sendMail.jsp這里mail-demo是你的上下文路徑也就是WAR包名或項目名啟動完成后頁面能正常顯示就可以開始測試發(fā)送了。5.2 功能驗證步驟我的驗證流程是這樣的開兩個郵箱一個作為發(fā)件方一個作為收件方兩個郵箱都用不同域名這樣才能檢驗跨服務器投遞。然后我在頁面上分別填寫收件人recipientotherdomain.com主題JavaMail原生發(fā)送測試內(nèi)容h2這是HTML內(nèi)容/h2p這是一封來自原生JavaWeb項目的郵件。/p點擊發(fā)送后如果頁面顯示郵件發(fā)送成功再去看收件方郵箱是否收到。為了確認整個鏈路完整我在MailSender中開著setDebug(true)控制臺會打印出一大段SMTP協(xié)議交互日志。關(guān)鍵的日志片段類似DEBUG SMTP: Connected to host: smtp.xxx.com, port: 465 DEBUG SMTP: AUTH LOGIN command mixed with SSL DEBUG SMTP: Use 8bit NTLM DEBUG SMTP: AUTH LOGIN succeeded DEBUG SMTP: MAIL FROM:your_accountexample.com DEBUG SMTP: RCPT TO:recipientotherdomain.com DEBUG SMTP: DATA當看到AUTH LOGIN succeeded和RCPT TO成功返回時基本可以判斷郵件已經(jīng)進入投遞流程。等收件方郵箱收到郵件說明整個鏈路是通的。5.3 控制臺日志怎么看很多同學面對一大段Debug日志會發(fā)懵我在這里簡單說一下怎么看。SMTP協(xié)議的命令都是有跡可循的220開頭的行服務器打招呼說明TCP連接成功250開頭的行請求被接受比如EHLO、MAIL FROM、RCPT TO成功334開頭的行服務器要求提供認證信息用戶名/密碼235開頭的行認證成功535開頭的行認證失敗常見原因是授權(quán)碼錯誤554開頭的行發(fā)送被拒絕可能是內(nèi)容觸發(fā)反垃圾策略把這幾個狀態(tài)碼記住絕大多數(shù)郵件發(fā)送問題都能在日志中直接定位。我也是用這個方法調(diào)通了整個項目后面要分享的幾個坑也全都靠日志才排查清楚。6. 常見問題與排查技巧實錄6.1 授權(quán)碼錯誤的經(jīng)典報錯第一次測試時我在發(fā)件人配置中填了真正的郵箱登錄密碼結(jié)果控制臺打出如下錯誤javax.mail.AuthenticationFailedException: 535 Error: authentication failed排查步驟很簡單先確認郵箱是否已開啟SMTP服務再確認授權(quán)碼是否有效。多數(shù)郵箱開啟SMTP服務后會明確提示授權(quán)碼僅顯示一次, 需要妥善保存如果遺忘了只能重新生成。把配置里的AUTH_CODE換成新授權(quán)碼問題就解決了。這是一個很多人會犯的錯誤因為登錄密碼和授權(quán)碼是兩個不同的東西登錄密碼只能在網(wǎng)頁Web端使用授權(quán)碼是專門提供給第三方客戶端使用的。所以拿到一個發(fā)不出去郵件的報錯先別慌著改代碼先檢查認證憑據(jù)。6.2 端口不通的排查記錄另一次測試中我配置了SMTP端口為25這是SMTP協(xié)議的默認端口但在部分網(wǎng)絡(luò)環(huán)境下25端口會被ISP封鎖日志顯示連接超時java.net.ConnectException: Connection timed out: connect排查方法是先用telnet smtp.xxx.com 25測試端口連通性。如果telnet連接不了果斷換成465或587端口。服務器防火墻規(guī)則、云服務商安全組這些網(wǎng)絡(luò)層面因素都可能導致端口不通。實際使用時我用465端口一切正常25端口則出現(xiàn)超時。這里有個經(jīng)驗如果你部署在云服務器上還要檢查安全組規(guī)則是否放行了對應出方向端口。大部分云廠商默認放行所有出方向端口但在部分企業(yè)內(nèi)網(wǎng)環(huán)境需要向網(wǎng)絡(luò)管理員申請開通。6.3 中文亂碼問題根因分析中文亂碼是另一個高頻問題。問題出現(xiàn)的現(xiàn)象是收件方收到郵件后主題顯示問號或亂碼正文中的中文也成了亂碼。根因在于編碼設(shè)置不一致。處理方法就是我前面代碼中體現(xiàn)的JSP頁面聲明UTF-8表單提交前使用UTF-8編碼Servlet中調(diào)用request.setCharacterEncoding(UTF-8)在讀取參數(shù)之前執(zhí)行setSubject指定UTF-8參數(shù)setContent聲明text/html;charsetUTF-8四個環(huán)節(jié)缺一不可。我在JSP頁面里還特意給表單加了accept-charsetUTF-8屬性雖然現(xiàn)代瀏覽器默認會按頁面編碼提交但多這一層保險總沒有壞處。另外一個隱蔽的坑是如果你的項目部署在Windows服務器上系統(tǒng)默認字符集是GBK某些文件的編碼如果被IDE用系統(tǒng)默認字符集保存了JSP編譯出來就會出亂碼。這種情況可以在server.xml中的Connector標簽添加URIEncodingUTF-8屬性確保GET請求參數(shù)的編碼也正確。6.4 頻繁發(fā)送觸發(fā)限流策略測試時如果短時間內(nèi)連續(xù)發(fā)送多封郵件可能會觸發(fā)郵箱服務商的反垃圾策略。服務器會返回類似這樣的錯誤554 Transaction failed這時不能繼續(xù)重試否則可能被封禁發(fā)信權(quán)限。正確做法是放慢發(fā)送頻率每次間隔至少一兩分鐘如果是正式項目需要批量發(fā)送建議設(shè)計異步隊列控制發(fā)送速率和日發(fā)送量上限。個人郵箱的日發(fā)送配額通常有限不建議拿個人郵箱做大規(guī)模生產(chǎn)發(fā)信。6.5 常見錯誤碼速查表為了方便排查我把一些常見問題整理成了表格現(xiàn)象可能原因解決思路535認證失敗授權(quán)碼錯誤重新生成授權(quán)碼并更新配置Connection timed out端口不通、防火墻攔截telnet測試端口更換465端口Could not connect to SMTP host服務器地址配置錯誤檢查郵箱服務商SMTP地址550 Mailbox not found收件人地址不存在確認收件人郵箱拼寫554 Transaction failed內(nèi)容觸發(fā)反垃圾策略降低發(fā)送頻率檢查郵件內(nèi)容主題顯示亂碼setSubject未指定編碼使用setSubject(subject, UTF-8)頁面表單中文亂碼Servlet未調(diào)用setCharacterEncoding在讀取參數(shù)前設(shè)置UTF-8這張表可以貼在你項目的README里后續(xù)維護時候查起來很方便。7. 進階擴展與個人經(jīng)驗總結(jié)7.1 如何加入附件支持現(xiàn)在實現(xiàn)的版本只支持純文本和HTML內(nèi)容。如果業(yè)務需要支持附件你需要在原來的MimeMessage基礎(chǔ)上使用MimeMultipart和MimeBodyPart構(gòu)造復合消息。MimeMultipart multipart new MimeMultipart(); // 正文部分 MimeBodyPart textPart new MimeBodyPart(); textPart.setContent(content, text/html;charsetUTF-8); multipart.addBodyPart(textPart); // 附件部分 MimeBodyPart filePart new MimeBodyPart(); DataSource source new FileDataSource(filePath); filePart.setDataHandler(new DataHandler(source)); filePart.setFileName(MimeUtility.encodeText(fileName, UTF-8, B)); multipart.addBodyPart(filePart); message.setContent(multipart);這里有個關(guān)鍵點setFileName需要進行MIME編碼處理否則中文文件名在收件人那里會變成亂碼。MimeUtility.encodeText幫我們把中文轉(zhuǎn)換為符合MIME規(guī)范的編碼。如果不做這步收件人下載附件時文件名就會顯示成亂碼——這個問題我實際測試時遇到過填入測試報告.pdf后收件人看到的是?UTF-8?B?...?這樣的長串令人頭大。7.2 支持多收件人與抄送實際業(yè)務中一封郵件可能需要發(fā)給多個收件人。JavaMail API支持在一條消息上添加多個收件人message.addRecipients(Message.RecipientType.TO, InternetAddress.parse(aexample.com,bexample.com));這里用的是addRecipients復數(shù)可以一次解析多個地址用逗號分隔。抄送則是message.addRecipient(Message.RecipientType.CC, new InternetAddress(ccexample.com));7.3 開發(fā)中的三點體會最后分享幾個我在整個實現(xiàn)過程中的體會這些不是代碼層面的知識但我覺得比代碼更重要。第一原生實現(xiàn)的最大價值不是不用框架而是讓你理解框架幫你做了什么。當你親手配置Session、看著Authenticator的調(diào)用、閱讀SMTP協(xié)議的調(diào)試日志你才真正理解為什么Spring Boot里只要填幾行配置郵件就能發(fā)出去——因為框架替你封裝了這一整條鏈路。有了這個理解再用框架時你排查問題會精準很多。第二很多奇怪的問題根源都是編碼不一致。我做這個項目時中文亂碼問題前前后后折騰了大半天從頁面排查到Servlet再到JavaMail的設(shè)置最后發(fā)現(xiàn)是JSP文件本身的編碼被IDE存成了GBK。所以項目創(chuàng)建之初就統(tǒng)一設(shè)置項目編碼為UTF-8文件編碼為UTF-8連接數(shù)據(jù)庫、寫頁面、返回響應都明確指定UTF-8能避免后續(xù)大量扯皮。第三調(diào)試信息是好朋友別嫌它煩。setDebug(true)打出的日志雖然長但它是你能看到的、客戶端和服務器之間的真實對話記錄。遇到問題時先看日志再說能省掉大量盲目試錯的時間。正式上線時關(guān)掉它否則日志文件會快速膨脹。這個項目的后續(xù)擴展方向其實不少比如把發(fā)件配置移動到數(shù)據(jù)庫表做成后臺可以動態(tài)管理的功能比如加入發(fā)送記錄表記錄每次發(fā)送的時間、收件人、狀態(tài)再比如做一個定時任務定期處理隊列中的待發(fā)郵件。每一步擴展都是對JavaWeb技術(shù)棧更深入的一次實踐。